ccccccccccccccccccccccccccccccccccccc. 

.. tttm 

cccccccccccccccccccc c c c c c c c c c c c ^Jjp* 

urn 



cccccccccccccccccc 
cccccccccccccccccc 
cccccccccccccccccccccccccC 




c c 



wmmm 



MiWttM 



ccccccccccccccccccccccccc cKJHJi 



cccccccccccccccccccc 



C C C C C Cjjp M)! ^M«J 

iiiiikiJilH! 



OO CL4SS LIBRARY ; 
FOUNDATION 
DATA STRUCTURES 



total 

iwuiiiii^^ 



OS/2 Version/ Volume One ^'Sl/BS 
User's Gu/c/e ..-*tfSM^^ 



' hX^^W/WOW^^^lfe^W. 

^. , a'..//a*v.v.v//.i.iv.'..' JirnvmA , 



mm 



Miill 

U'IMM 
MttXtU 



Ipiiilill 
IMiilPM 



KftttMJMKfl 




ujjjjj/JAwjjjJL/.yAijii 



liiiiiii 

MM! 



EXHIBIT E 

Title: Business Analysis & Management Systems 

Utilizing Enterprise Metrics 
Inventors: Michael M. Mann & Arne Haugland 
Attys.: Fulwider Patton et al. Dkt. # 65568/ENCMP 



C+O Class Library 
User's Guide 
Volume 1: Foundation Data Structures 

Revision 1.2 July, 1988 



For the OS/2 Operating System 



Objective Systems 



Information in this document is subject to change without notice and does not represent a 
commitment on the part of Objective Systems. The software described in this document is 
furnished under a license agreement. The software may be used or copied only in accordance 
with the terms of the agreement. No part of this manual may be reproduced or transmitted in 
any form or by any means, electronic or mechanical, including photocopying and recording, for 
any purpose other than the purchaser's personal use without the written permission of Objective 
Systems. 



Objective Systems 

2443 Fillmore Street 
Suite 249 
San Francisco. California 941 15 

Tel: 415/929-0964 
Fax: 415/ 929-8015 



© Copyright Objective Systems 1988. 
All rights reserved 



C+O™ is the trademark of Objective Systems. 



This manual was produced in its entirety with the Objective Systems Object- 
Oriented CASE documentation tool and Microsoft Word. Output was to a 
PostScript printer. 



Table of Contents 



USER'S GUIDE 



Introduction i 

Class Inheritance Diagram ii 

Quick Reference: Class Functions iii - xiv 

C+O Datatypes Table xv - xviii 

One Getting Started 1-6 

Manual Organization 1 

Installing C+O Class Libraries 2 

Source Code Organization 3 

Library Organization 4 

Test-Driving Classes 5 

Two How to Write a Program Using C+O Class Libraries 1-6 

Anatomy of a C+O Program 1 

Creating A Class of Your Own 4 

Debug and Production Libraries 4 

Compiling 5 

Linking 6 

Debugging 6 

Optimizing 6 

Three The Object-Oriented Approach to Developing Software .1-32 

Introduction 1 

Background 2 

Classes 3 

Objects 5 

Designing with Class 6 

Foundation .7 

Advanced Inheritance 11 

Visiting Objects 16 

Sending Messages 18 

MetaClass 21 

Frameworks 25 

Overriding Messages and Multiple Inheritance 28 

What's In a Name? 30 

Conclusion 31 



Table of Contents 
(com.) 



Class Summary 

Blk- Block 1-6 

CIs -Class ' 1-8 

Dll-List 1-8 

Dpa - DynamicArray 1-8 

Edg-Edge .1-8 

Grf- Graph 1-8 

Jul - JulianTime 1-8 

Lei - ListElement .1-8 

McNMetaClass 1-6 

Mem -Memory 1-4 

Mms - MetaMessage 1-6 

Msc - MetaSuperClass 1-4 

Msg - Message 1-6 

Obj- Object 1-6 

Str- String 1-4 

Tre-Tree 1-12 

Tsk-Task. , 1-6 

Vtx- Vertex . 1-8 



Appendix A • Class Exceptions Reference . ' 1-54 



Introduction 



Congratulations on your purchase of C+O Class Libraries, Volume 1: 
Foundation Data Structures! C+O is a new kind of product called a Class 
Library, Class libraries are different from other kinds of libraries because they 
can model general purpose data structures, not just DOS interfaces or user 
interfaces. Secondly, class libraries are new because they employ object- 
oriented programming techniques. What makes this so important is that it 
establishes new levels of reusability. 

In creating C+O Class Libraries, we have always kept the following things in 
mind: 

1 . Programmers are the toughest customers around — especially 
when it comes to using someone else's source code. 

2. The documentation is at least as important as the code. 

3. Debugging aids are an important mechanism for understanding 
and learning to use a library. 

4. Examples, examples, examples. 

5. A picture is worth many pages of text, many hours of debugging 
and many support calls. 

We think you will be pleasantly surprised how much we took these principles 
to heart. 

At Objective Systems, we are firmly committed to the concept of reusable code. 
C+O was originally developed for our own use in developing a variety of 
commercial products. We believe that object-oriented techniques are the 
solution to the reusability problem. 

At Objective Systems, we are firmly committed to standards. C+O is fully 
compliant with ANSI C conventions. C+O is named using SAA naming 
conventions. As standards for object-oriented programming emerge, we will 
adapt C+O class libraries to those standards as well. 

Finally, C+O is a living product. It will be continually enhanced and upgraded. 
We value your suggestions and comments and will strive to incorporate them in 
future releases. Over time, we will porting C+O to other hardware and software 
platforms as well as coming out with new libraries. Please let us know what 
you would like to see. 

Should you have any problems or questions regarding C+O class libraries, 
please give us a call. We are available from 9am to 7pm West coast time. 
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Function Name Description Page Scope Macro 



BlkClear 


Clear instance 


Blk-2 


Public 


N 


BlkOelnit 


Deinitialize instance 


Blk-3 


Public 


N 


BlkExecute 


Execute method with parameters 


Blk-4 


Public 


N 


BlkExecuteRetBool 


Execute the method, return int 


Blk-5 


Public 


N 


BlkExecuteRetDataPtr 


Execute method, return mem pointer 


Blk-6 


Public 


N 


BlkExecuteRetFuncPtr 


Execute method, return function ptr 


81k - 7 


Public 


N 


BlkExecuteRetlnt 


Execute method, return int 


Blk-8 


Public 


N 


BlkHasMethod 


Return True if instance has non-NULL method 


Blk-9 


Public 


N 


Blklnit 


Initialize instance 


Blk-10 


Public 


N 


BlkPrint 


Print contents of instance 


Blk-11 


Public 


N 


BlkPushDataPtr 


Save pointer parameter 


Blk-12 


Public 


N 


BlkPushFuncPtr 


Save function pointer parameter. 


Blk-13 


Public 


N 


BlkPushLargelnt 


Save Largelnt parameter 


Blk-14 


Public 


N 


BlkPushMediunilnt 


Save Mediumlnt parameter 


Blk-15 


Public 


N 


BlkSetMethod 


Set the function to call 


Blk-16 


Public 


N 



CIsCreateMessages 


Create the Msg instances 


N/A 




Undoc 


N 


ClsCreateObject 


Create a new Object instance 


Cls- 


2 


Public 


N 


ClsCreateSupers 


Create the superclass instances 


N/A 




Undoc 


N 


CIsDelnit 


Deinitialize the instance 


CIs- 


3 


Public 


N 


CIsDestroy 


Deallocate the instance 


CIs- 


4 


Public 


N 


CIsDestroyMessages 


Destroy the messages 


N/A 




Undoc 


N 


CIsDestroyObject 


Deallocate the object instance 


Os- 


5 


Public 


N 


ClsOestroySuperClasses 


Destroy the superclasses 


N/A 




Undoc 


N 


CIsFindMsg 


Find message given selector name 


CIs - 


7 


Public 


N 


CIsFindSelectorlndex 


Find index of selector given name 


CIs- 


8 


Public 


N 


CIsFindSuperClass 


Find superclass given name 


CIs- 


10 


Public 


N 


CIsGetMessageCount 


Get number of messages 


CIs- 


11 


Public 


N 


CIsGetMethodAndOffset 


Return method and sub/super offset 


CIs- 


12 


Public 


N 


CIsGetName 


Return name of the instance 


CIs- 


14 


Public 


N 


CIsGetNthMsg 


Get pointer to nth Message 


CIs- 


15 


Public 


N 


CIsGetNthSuperClass 


Get pointer to Nth superclass 


CIs- 


16 


Public 


N 


CIsGetObjectSize 


Return size of an object instance 


CIs- 


17 


Public 


N 


CIsGetOffsetForMsg 


Return sub/super offset of object 


Os- 


18 


Public 


N 


CIsGetOffsetOfNthSuper 


Return offset of nth superobject 


CIs- 


20 


Public 


N 


CIsGetRootSubClass 


Get the root subclass 


CIs- 


22 


Public 


N 


CIsGetRootSubObjectOffset 


Return offset of root subobject 


CIs- 


23 


Public 


N 


CIsGetRootSubObjectSize 


Return size of the root subobject 


CIs - 


24 


Public 


N 


CIsGetSize 


Return size of the instance 


Cls- 


25 


Public 


N 


CIsGetSubClass 


Return subclass 


Qs- 


26 


Public 


N 


CIsGetSubObjectOffset 


Return offset of a subobject 


CIs- 


27 


Public 


N 



iii 
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CIsGetSuperClasslndex 


Return superclass index 


as- 


29 


Public 


N 


Clslnit 


Initialize the instance 


CIs- 


30 


Public 


N 


CIslsRoot 


Is instance the root subclass? 


CIs- 


31 


Public 


N 


ClsOffsetSupers 


Offset superclasses from subclass. 


N/A 




Undoc 


N 


ClsPrint 


Print the instance 


CIs- 


32 


Public 


N 


ClsSendOestroy 


Send destroy message to instance 


as- 


33 


Public 


N 


CIsSendObjectMessage 


Send object a message 


CIs- 


34 


Public 


N 


CIsSendObjectMessageRetumlnt 


Send object message, returns Medium Int 


CIS- 


36 


Public 


N 


CIsSendObjectMessageRetumPtr 


Send object message, returns Void * 


CIs- 


38 


Public 


N . 


ClsSuperClassOf 


Initialize sub/super relation 


N/A 




Undoc 


N 



DIIAppend 


Append element to list 


Dll 


• 2 


Public 


N 


DIIAppendLast 


Make element last 


Dll 


•4 


Public 


Y 


DIIAsObj 


Return list as object 


Dll 


•6 


Private 


Y 


DHCIear 


Clear the list 


Dll 


• 7 


Public 


N 


DllCut 


Cut one element from list 


Dll 


•8 


Public 


N 


DilCutChildren 


Cut all elements from list 


Dll 


•10 


Public 


N 


DIICutRange 


Cut element(s) from list 


Dll 


•11 


Public 


N 


uuueinii 


ueinitiaiize list ooject 


Dll 


•13 


Public 


N 


DIIDestroy 


Deinitialize list object and free space 


Dll 


•14 


Public 


N 


DBGetClient 


Return client of list 


Dll 


■15 


Public 


Y 


DIIGetRrst 


Return first element 


Dll 


•16 


Private 


Y 


DIIGetLast 


Return last element 


Dll 


■17 


Private 


Y 


DIIGetNth 


Return Nth element 


Dll 


•18 


Private 


N 


DIIGetSize 


Get size of list 


Dll 


•19 


Public 


N 


Dlllnit 


Initialize list object 


Dll 


•20 


Public 


N 


Dll Insert 


Insert element in list 


Dll 


•21 


Public 


N 


DliinsertFirst 


Make element first 


Dll- 


•23 


Public 


Y 


DlllsEmpty 


Return True if list empty 


Dll 


•25 


Public 


Y 


DflLelCiientCount 


Visit function: count elements conditionally 


Dll 


■26 


Public 


N 


DHLelClientRnd 


Visit search function: all elements 


Dll 


-28 


Public 


N 


DIILeiClientFirst 


Return client of first element 


Dll- 


•30 


Public 


Y 


DIILelClientGetNth 


Return Nth client 


Dll 


•31 


Public 


N 


DIILelCIientLast 


Return client of last element 


Dll 


•33 


Public 


Y 


DilLetCIientVisitBwd 


Visit function: all elements 


Dll 


■34 


Public 


N 


DilLelClientVisitFwd 


Visit function: all elements 


Dll 


•36 


Public 


N 


DIINotifyCutRange 


Cut elements 


Dll 


•38 


Friend 


N 


DilNotifyPasteRange 


Paste elements 


Dll 


■39 


Friend 


N 


DIlPasteRangeAfter 


Paste element(s) to list 


Oil 


•40 


Public 


N 


DIIPasteRangeBefore 


Paste elements) in list 


Dll 


■42 


Public 


N 


DIIPasteRangeRrst 


Paste elements) to be first in list 


Dll 


•44 


Public 


Y 


DIIPasteRangeLast 


Paste elements) to end of list 


Dll 


■46 


Public 


Y 


DIISendDestroy 


Send message for list destruction 


Dll 


•48 


Public 


N 



iv 
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Page 


Scope Macro 


DpaAppend 


Append an element 


Dpa- 2 


Public 


N 


DpaOear 


Clear dynamic array 


Dpa -4 


Public 


N 


DpaCount 


Visit function: count True returns 


Dpa -5 


Public 


N 


DpaCountRange 


Visit function: range with return checking 


Dpa-7 


Public 


N 


DpaDelnit 


Deinitialize the dynamic array object 


Dpa -9 


Public 


N 


DpaDelete 


Delete elements) 


Dpa -10 


Public 


N 


OpaDestroy 


Deinitialize array object and free space 


Dpa -12 


Public 


N 


DpaExpand 


Paste Null elements) into array 


Dpa-13 


Public 


N 


DpaFind 


Rnd index returning True 


Dpa -15 


Public 


N 


DpaRndPlrBwd 


Rnd index with matching pointer 


Dpa -17 


Public 


N 


DpaRndPlrFwd 


Rnd index with matching pointer 


Dpa -19 


Public 


N 


DpaFindRangeBwd 


Rnd index returning True for range 


Dpa -21 


Public 


N 


DpaRndRangeFwd 


Rnd index returning True for range 


Dpa -23 


Public 


N 


DpaGetLast 


Return last element in array 


Dpa -27 


Public 


N 


DpaGetNlh 


Return Nth array element 


Dpa -25 


Public 


N 


DpaGetSize 


Return number of elements 


Dpa -29 


Public 


N 


Dpalnit 


Initialize the edge object 


Dpa-31 


Public 


N 


DpaNewArray 


Create a new array 


N/A 


Undoc 


N 


DpaResize 


Resize the array 


N/A 


llnrinr 

W4 tUUv 




DpaSetNth 


Set Nth element of array 


Dpa -33 


Public 


N 


DpaSetRegionNuIl 


Make region of elements Null 


Dpa -35 


Public 


N 


DpaSetSize 


Set array size to N elements 


Dpa -37 


Public 


N 


OpaShiftOown 


Shift down N elements in array 


Dna - 38 


Public 


N 


DpaShiftUp 


Shift up N elements in array 


Dpa -40 


Public 


N 


Dpa Visit 


Visit function: all elements 


Dpa -42 


Public 


N 


DpaVisitCIient 


Visit function: all elements 


Dpa -44 


Public 


N 


DpaVisitRange 


Visit function: range of elements 


Dpa -46 


Public 


N 


OpaVisitRegion 


Visit function: region of elements 


Dpa-48 


Public 


N 


DpaVisitSelfAndSuccessors 


Visit function: client and successors 


Dpa -50 


Public 


N 



EdgAsGrfLel 


Return graph list element for edge 


Edg-2 


Friend 


Y 


EdgAslnLel 


Return incoming edge list element 


Edg-3 


Friend 


Y 


EdgAsObj 


Return edge as object 


Edg -4 


Private 


N 


EdgAsOutLel 


Return outgoing edge list element 


Edg-5 


Friend 


Y 


EdgClear 


Clear the edge 


Edg-6 


Public 


N 


EdgComparelnVtx 


Compare incoming vertex 


Edg-7 


Public 


N 


EdgConnectToGrf 


Connect edge to graph 


Edg -9 


Public 


Y 


EdgConnectToVertices 


Connect edge to vertices 


Edg-11 


Public 


N 


EdgDelnit 


Deinitialize the edge object 


Edg - 13 


Public 


N 


EdgOestroy 


Deinitialize edge object and free space 


Edg-14 


Public 


N 


EdgDisconnectFromGrf 


Disconnect edge from graph 


Edg - 15 


Public 


Y 


EdgDisconnectFromVertices 


Disconnect edge from vertices 


Edg -17 


Public 


N 



V 
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EdgGetClient 


Return client of edge 


Edg 


•19 


Public 


Y 


EdgGetGrf 


Return graph 


Edg< 


•20 


Friend 


Y 


cuyocin i via 


Rah ifn inonminn vortov 


cog 


* C 1 


rn&riu 


V 
T 


EdgGetNextln 


Return next incoming edge 


Edg 


•23 


Friend 


Y 


EdgGetNextOut 


Return next outgoing edge 


Edg 


•25 


Friend 


Y 


EdgGetOutVtx 


Return outgoing vertex 


Edg 


•27 


Friend 


Y 


EdgGetVertices 


Return vertices to edge 


Edg 


•29 


Public 


Y 


EdgHasVertices 


Does edge have any vertices 


Edg 


•31 


Public 


N 


EdglnGrf 


Is edge in graph 


Edg 


•32 


Public 


Y 


Edglnit 


Initialize the edge object 


Edg 


•33 


Public 


N 


EdgSendDestroy 


Send message for edge destruction 


Edg 


•34 


Public 


Y 


EdgUpdatelnVtx 


Replace incoming vertex 


Edg 


•35 


Public 


N 


EdgUpdateOutVtx 


Replace outgoing vertex 


Edg 


•37 


Public 


N 



GriAnyCycles 


Check graph for cycles 


Grf-2 


Public 


Y 


GrfAsEdgDII 


Return List of edges 


Grf-4 


Friend 


N 


GrfAsObj 


Return graph as object 


Grf-5 


Private 


N 


GrfAsVtxDII 


Return List of vertices 


Grf-6 


Friend 


N 


GrfBasicTopologicalSort 


Do topological sort of graph 


N/A 


Undoc 


N 


GrfClear 


Clear the graph 


Grf-7 


Public 


N 


GriCountEdg 


Count edges of graph 


Grf-8 


Public 


Y 


GrfCountVtx 


Count vertices of graph 


Grf-10 


Public 


Y 


GriDelnit 


Deinitialize Graph object 


Grf-12 


Public 


N 


GrtDestroy 


Deinitialize Graph object and free space 


Grf-13 


Public 


N 


GrfDoTopologicalSort 


Do topological sort of graph 


Grf-14 


Public 


Y 


GrfFindEdgClient 


Visit search function: edges 


Grf-16 


Public 


N 


GrfFindVtxClient 


Visit search function: vertices 


Grf-18 


Public 


N 


GriGetClient 


Return client of graph 


Grf-20 


Public 


N 


Grflnit 


Initialize Graph object 


Grf-21 


Public 


N 


GrfSendOestroy 


Send message for graph destruction 


Grf-22 


Public 


N 


GrfVisitEdgQient 


Visit function: edges 


Grf-23 


Public 


N 


GrfVisitVtxClient 


Visit function: vertices 


Grf-25 


Public 


N 


GrtVisitVtxClientlnTopOrderBwd 


Visit function: backward topological order 


Grf-27 


Public 


N 


GrfVisitVtxClientlnTopOrderFwd 


Visit function: forward topological order 


Grf-29 


Public 


N 



JulAddDays 


Add/subtract days to date 


Jul -2 


Public 


Y 


JulAddDaysL 


Add/subtract days to date (long) 


Jul -4 


Public 


Y 


JulAddMonths 


Add/subtract months to date 


Jul -6 


Public 


N 


JulAddQuarters 


Add/subtract quarters to date 


Jul -8 


Public 


N 


JulAddYears 


Add/subtract years to date 


Jul - 10 


Public 


N 


JulCalendarToJulian 


Day, month, year to julian day 


Jul - 12 


Public 


N 



vi 
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JulCopy 


Copy julian day 


Jul 


■14 


Public 


Y 


JulDateStrToJulian 


Date string to julian day 


Jul 


•16 


Public 


N 


JulDayOfWeek 


Day number in week 


Jul 


■18 


Public 


Y 


JulDayOfYear 


Day number in year 


Jul 


■20 


Public 


N 


JulDayslnMonth 


Days in month 


Jul 


■22 


Public 


N 


JutDayslnGuarter 


Days in quarter 


Jul 


•24 


Public 


N 


JulDayslnYear 


Days in year 


Jul 


■26 


Public 


N 


JulDiff 


Days between two dates 


Jul 


•28 


Public 


Y 


JuOffL 


Days between two dates (long) 


Jul 


•30 


Public 


Y 


JulGetSystemJuIianDay 


System date as julian day 


Jul 


•32 


Public 


N 


Jullnit 


Set to beginning of calendar January 1, 1583 


Jul 


•34 


Public 


Y 


JullsLeapYear 


Is date in leap year 


Jul 


•36 


Public 


N 


JullsMaxValue 


Is date maximum julian value 


Jul 


•38 


Public 


Y 


JulMax 


The maximum of two julian dates 


Jul 


■40 


Public 


Y 


JuIMin 


The minimum of two iulian dates 


Jul- 


■42 


Public 


Y 


JulMonthDayDiff 


Days between date and a day/month 


Jul 


•44 


Public 


N 


JulMonthString 


Rll string with month and year 


Jul 


•46 


Public 


N 


JulQuarterString 


Fill string with quarter and year 


Jul- 


•48 


Public 


N 


JulSameDayMonth 


Two dates same day and month 


Jul- 


•50 


Public 


N 


JulSetMaxDate 


Set date to maximum value 


Jul- 


•52 


Public 


N 


JulToCalendar 


Julian day to day, month, year 


Jul- 


■54 


Public 


N 


JulToDateStr 


Ril date string of specified format 


Jul 


•56 


Public 


N 


JulValidateOate 


Validate date passed as string 


Jul- 


•58 


Public 


N 


JulWeekString 


Rll string with day and month 


Jul 


•60 


Public 


N 


JulYearString 


Rll string with year 


Jul- 


-62 


Public 


N 



LeIAsObj 


Return element as object 


Lei -2 


Private 


Y 


LeICIientCount 


Return count for client and successors 


Lei -3 


Public 


N 


LeOentDII 


Return client of list 


Lei -5 


Public 


Y 


LeICIientRndRange 


visit search function: range 


Lei -6 


Public 


N 


LeICIientNext 


Return client of next element 


Lei -8 


Public 


Y 


LeICIientPrev 


Return client of previous element 


Lei -9 


Public 


Y 


LeICIientVisitBwd 


Visit function: client and predecessors 


Lei - 10 


Public 


N 


LeICIientVisitFwd 


Visit function: client and successors 


Lei -12 


Public 


N 


LeICiientVisitPredecessors 


Visit function: predecessors 


Lei • 14 


Public 


N 


LelClientVlsitRange 


Visit function: range 


Lei - 16 


Public 


N 


LelQientVlsitSuccessors 


Visit function: successors 


Lei - 18 


Public 


N 


LeICountRange 


Count elements 


Lei -20 


Public 


N 


LeICut 


Cut element from list 


Lei -22 


Public 


N 


LeICutRange 


Cut elements) from list 


Lei -24 


Public 


N 


LeICut RangeFromList 


Cut element(s) from list 


N/A 


Undoc 


N 


LeIDelnit 


Deinitialize list element object 


Lei • 26 


Public 


N 
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97 

CI 


rUUllly 


M 


LeIGetClient 


Return client 


Let - 


28 


Public 


Y 


LeIGetDII 


Return list object 


Lei - 


29 


Friend 


Y 


LeIGetNext 


Return next element 


Lel- 


30 


friend 


Y ! 


LelGetNthSuccessor 


Return Nth element 


Lel- 


31 


Friend 


N 


LeIGetPrev 


Return previous element 


Lel- 


32 


Friend 


Y 


Lellnit 


Is element in list 


Lel- 


33 


Public 


N 


LeIPasteRange After 


Append elements(s) to list 


Lel- 


34 


Public 


N 


LelPasteRangeBefore 


Insert elements) to list 


Lel- 


36 


Public 


N 


LeIPasteRangeToList 


Insert elements) to list 


N/A 




Undoc 


N I 


LelSendOestroy 


Send message for list element destruction 


Lei- 


38 


Public 


N 


LeITest 


Test for valid list element 


Lei - 


39 


Public 


N 


LeIVisitRange 


Visit function for range 


Lei - 


40 


Private 


N 



MclCreateGlass 


Create a class instance 


Mcl- 


2 


Private 


N 


MclDestroyClass 


Destroy a class instance 


Met- 


•3 


Friend 


N 


MdRndSelector 


Rnd a selector index given its name 


Mcl 


■5 


Public 


N 


MclFindSuperClass 


Find the superclass index given its name 


Mcl 


•6 


Public 


N 


MclGetClassName 


Get the class name 


Mcl- 


■7 


Public 


N 


MclGetClassSize 


Return the size of a class instance 


Mcl 


-8 


Public 


N 


MclGetMessageCount 


Return the number of messages 


Mcl- 


•9 


Public 


N 


MclGetNthMms 


Return the Nth MetaMessage 


Mcl- 


•10 


Public 


N 


MclGetNthOffset 


Return the Nth Superclass offset 


Met 


•11 


Public 


N 


MclGetNthSuper 


Return the MetaClass 


Mci- 


•12 


Public 


N 


MclGetSuperClassCount 


Return the number of superclasses 


Met- 


•13 


Public 


N 


MclPrint 


Print the MetaClass instance 


Mcl 


■14 


Public 


N 


MclSendCreateClass 


Return a new instance of the MetaClass 


Mcl 


•15 


Public 


N 


MclSendDestroyClass 


Deallocate an instance of a Class 


Mcl 


•16 


Public 


N 


MclValidate 


Validate that the instance is valid 


Mcl 


•17 


Public 


N 


MclValidateMessages 


Validate the MetaMessages 


N/A 




Undoc 


N 


MclValidateSuperClasses 


Validate the MetaSuperClasses 


N/A 




Undoc 


N 



MemClear 


Clears array elements 


Mem- 


•2 


Public 


N 


Mem Copy 


Copy array elements within the array 


Mem 


•3 


Public 


N 


MemCutNSet 


Delete elements, shift remaining 


Mem 


•5 


Public 


N i 


Mem Destroy 


Deallocate memory 


Mem 


■6 


Public 


N 


Mem Duplicate 


Copy array into another 


Mem - 


•7 


Public 


N 


Mem New 


Allocate memory 


Mem- 


•8 


Public 


N 


MemPasteNSet 


Expand array, shift remaining 


Mem 


•9 


Public 


N 


MemSetChr 


Set elements to character 


Mem- 


•10 


Public 


N 
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MmsGetMethod 


Get the method 


Mms-2 


Public 


N 


MmsGetSelector 


Get the name of selector 


Mms-6 


Public 


N 


MmsGetSuper 


Get name of superclass 


Mms-4 


Public 


N 


MmsPrint 


Display the instance 


Mms-7 


Public 


N 


MmsValidate 


Validate the instance 


Mms-8 


Public 


N 



MscGetMetaClass 


Get the MetaClass 


Msc 


■3 


Public 


N 


MscGetName 


Get the name of superclass 


Msc 


■2 


Public 


N 


MscGetOffset 


Get offset of superclass 


Msc- 


•4 


Public 


N 


MscPrint 


Display the contents of the MetaSuperCiass 


MSC 


-5 


Public 


N 


MscVaiidate 


Validate that the instance is valid 


MSC 


•6 


Public 


N 



MsgDelnit 


Deinit instance 


Msg 


•2 


Public 


N 


MsgGetMethod 


Return method 


Msg- 




Public 


N 


MsgGetOffset 


Return the object offset 


Msg- 


•3 


Public 


N 


MsgGetSelector 


Return selector 


Msg- 


•5 


Public 


N 


Msglnit 


Initialize instanc 


Msg- 


•6 


Public 


N 


Msg Print 


Print the instance 


Msg- 


•7 


Public 


N 


MsgSend 


Send message to object 


Msg- 


•8 


Public 


N 


MsgSendRetumlnt 


Send message to object, return int 


Msg- 


9 


Public 


N 


MsgSendReturnPtr 


Send message to object, return pointer 


Msg« 


10 


Public 


N 


MsgSetSuperOffsetAndMethod 


Override the method 


N/A 




Undoc 


N 



ObjDelnit 


Deinitialize instance 


Obj- 


2 


Public 


N 


ObjDestroy 


Deinitialize and deallocate object 


Obj- 


3 


Public 


N 


ObjGetClient 


Return a client 


Obj- 


4 


Public 


N 


ObjGetCiientOrNull 


Return client if non-NULL 


Obj- 


6 


Public 


N 


ObjGetCIs 


Return class 


Obj- 


8 


Public 


N 


ObjGetClsName 


Return class name 


Obj- 


9 


Public 


N 


ObjGetlmmediateCiient 


Return immediate client 


Obj- 


10 


Public 


N 


ObjGetMethodAndOffset 


Return method and client offset 


Obj- 


11 


Public 


N 


ObjGetNthSuperObject 


Return nth superobject 


Obj- 


13 


Public 


N 


ObjGetRootClient 


Get root client 


Obj- 


14 


Public 


N 


ObjGetRootClientSize 


Get root object size 


Obj- 


15 


Public 


N 


ObjGetSize 


Get object size 


Obj- 


16 


Public 


N 


ObjGetSubObjectOffset 


Return offset to immediate subobject 


Obj- 


17 


Public 


N 


Objlnit 


Initialize object 


Obj- 


18 


Public 


N 


ObjlsRoot 


Return Treu if is root subobject 


Obj- 


19 


Public 


N 


ObjRespondsToSelector 


Does object understand message? 


Obj- 


20 


Public 


N 
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ObjSendMessage 


Send message to object 


Obj-21 


Public 


N 


ObjSendMessageRetumlnt 


Send message to object, return Int 


Obj-22 


Public 


N 


ObjSendMessageRetumPtr 


Send message to object, return pointer 


Obj-23 


Public 


N 



StrBasicExtract 


Extract a string 


N/A 


Undoc 


N 


StrExtract 


Extract siring as specified 


Str-2 


Public 


N 


StrFromDate 


nil string with a date 


Str-4 


Public 


N 


StrFromMediumlnt 


Integer to string 


Str-6 


Public 


N 


Strlnit 


Init string to zero 


Str-8 


Public 


Y 


StrReplaceSubStr 


Replace sub-string in string 


Str-9 


Public 


N 


StrSet 


Copy string to another 


Sir- 11 


Public 


Y 


StrSqueeze 


Removes any character from string 


Str-13 


Public 


N 


StrToOate 


Parse a date string for year, month, day 


Str-15 


Public 


N 


StrToLower 


Change case of string to lower 


Str-17 


Public 


Y 


StrToMediumlnt 


String to integer 


Str-19 


Public 


N 


StrToUpper 


Change case of string to upper 


Str-21 


Public 


Y 



TreAsDIl 


Return node as list 


Tre- 


■2 


Private 


Y 


TreAsLel 


Return node as list element 


Tre 


•3 


Private 


Y 


TreAsObj 


Return node as object 


Tre 


•4 


Private 


Y 


TreClear 


Clear the tree 


Tre 


•5 


Public 


N 


TreClient 


Return client of node 


Tre- 


6 


Public 


Y 


TreClientFindChild 


Visit search function: children 


Tre 


•7 


Public 


N 


TreClientFirstChild 


Return first child node as client 


Tre 


■9 


Public 


Y 


TreClientLastChild 


Return last child node as client 


Tre 


•11 


Public 


Y 


TreClientLastLeaf 


Return last leaf node as client 


Tre 


•13 


Public 


Y 


TreClientNext 


Return next node as client 


Tre- 


■15 


Public 


Y 


TreClientNextPreOrder 


Return next PreOrder client node 


Tre- 


•17 


Public 


Y 


TreClientNextUncle 


Return next uncle as client 


Tre 


■19 


Public 


Y 


TreClientParent 


Return parent node 


Tre- 


•21 


Public 


Y 


TreClientPrev 


Return prev client 


Tre- 


23 


Public 


Y 


TreClientPrevPreOrder 


Return previous client PreOrderiy 


Tre- 


•25 


Public 


Y 


TreClientVisitBranchlnOrder 


Visit function: branch in-order 


Tre- 


•27 


Public 


N 


TreClientVisitChildren 


Visit function: all children 


Tre 


•29 


Public 


N 


TreClientVisitChildrenBwd 


Visit function: all children 


Tre 


•31 


Public 


N 


TreClientVisitDescBranchlnOrder 


Visit function: descendents 


Tre 


■33 


Public 


N 


TreClientVisitDesclnOrder 


Visit function: descendents 


Tre- 


35 


Public 


N 


TreClientvlsitDesclnOrderBwd 


Visit function: descendents 


Tre- 


•37 


Public 


N 


TreClient VisitDescLeaves 


Visit function: descendents 


Tre- 


•39 


Private 


N 


TreClientvlsitDescPreOrder. 


Visit function: descendents 


Tre- 


•41 


Public 


N 


TreClientVisitlnOrder 


Visit function: in-order 


Tre- 


•43 


Public 


N 


TreClientVlsitlnOrderBwd 


Visit function: in-order 


Tre- 


45 


Public 


N 
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Pimrttan Mama 




Dfl A A 

rage 


Scope Macro 


XroOlionfV/icitl oo\/ac 
1 rcUli€niVI5llLcaV6S 


\/icif fiinr*tirtn* loo wo £ 

VI5II Tuncuon. leaves 


Xro . Al 
lie • *fi 


Public 


N 


I icUirtJMl Vlbl inaici lib 


X/icit fitnr*frion* nooKoct nornnfc firet 

vibii luiicuun. nearesi paicnis nrsi 


Xro - AQ 

ir e - ■ki 


Public 


N 


Xro 1 1 o ri f\ /I *» ■ {QmA rv4 a r 


visii mncuon. pre-oroer 


ire - oi 


Public 


N 


i reuientvtsitHange 


\/|a!I d iaaIia P% • W^RM/V 

visit function, range 


ire -5o 


Public 


N 


i reuiieni visuouccrreuruer 


visii Tuncuon. ail successors 


Xra 

ire - oi) 


Public 


N 


i reuientvisitbuccessors 


visit function, successors 


ire -57 


Public 


N 


i reoutonnaren 


Cut children from tree 


T»« CA 

ire - 59 


Public 


Y 


i reoutHange 


Cut node(s) from tree 


Tre -61 


Public 


Y 


Ti>/-* PX/^ Inii 

i reueinit 


Deinitialize Tree object 


Tre -63 


Public 


N 


TreDestroy 


Deinitialize Tree object and free space 


Tre -64 


Public 


N 


Treuestroycniiaren 


Destroy any children of a tre 


Tre -65 


Public 


N 


I rerirstuniid 


Heturn first cniid 


Tre -66 


Private 


Y 


I renasuniiuren 


uoes node nave any children 


Tre -68 


Public 


Y 


i renasoiDiings 


uoes nooe nave any sionngs 


ire -69 


Public 


Y 


Trelnit 


initialize tree ooject 


T rA 7A 

i re - 70 


Public 


N 


TralePhilH 

I reisuniiu 


uoes me nooe nave a pareni 


ire - /i 


Public 


Y 


Xro Ic ro^t A nwietA r 


is nooe a oirect ancester 


ire - fc 


Public 


N 


Tifl 1 m D Art ♦ 

1 reisnooi 


uoes tne nooe nave no parent 


1 re - 73 


Public 


Y 


Tm| ocfThilH 


neiurn last cniiu 


Xra 7>i 

i re * 


Private 


Y 


T»a| ooil 


Heturn last leaf 


TrA 7C 

I re - 7o 


Private 


N 


XroMoyt 


neium next nooe 


Xro 7ft 

i re - to 


Private 


Y 


X ro Kl a vfD r aH r Wo r 


neium next nooe k reurceny 


i re - oU 


Private 


N 


i reNextuncie 


Return next uncle 


Tre - 82 


Private 


N 


1 rerareni 


Heturn parent node 


X*n 0>( 

ire -84 


Private 


Y 


i rerasteHangeAiteroiDiing 


raste range of siblings 


T**\ OO 

Tre -86 


Public 


Y 


I i6rasi6Kang6D6ioreoiDiing 


raste range of sionngs 


ire -88 


Public 


Y 


I reraSienangerirsiuniia 


raste cniiaren 


t.- aa 

i re - 90 


Public 


Y 


i rer dSienangeLdSioniiu 


raste cniiaren 


ire -92 


Public 


Y 


i rerrev 


neajrn previous nooe 


Xro QA 

i re - 94 


Private 


Y 




Hetum previous nooe rreuroeny 


Xra OC 

ire - 9o 


Private 


N 


i reoenauesuoy 


oeno message tor tree destruction 


Xro OO 

I re - 98 


Public 


N 


i re visiiDiwtuiinuruer 


visit tuncuon. urancn in-oroer 


Xro QQ 

i re - 99 


Private 


N 


Xro \/i GitOhil H ro n 


visit lunciion. cniiaren 


Xro 1H1 

ire - lui 


Private 


N 


XroX/I c itr^hi 1 fi ro n ftuuri 


visii lunciion. cniiaren 


Xrn 1 0 rt 

i re - 1 uo 


Private 


N 


Tro\/i citr^oc/^Rronr+i InOrHor 
1 fc VIoUL^oODiaJluIlf luiUci 


visit luncuon. aescenaents 


Xro 

ire - luo 


Private 


N 


i revisiiuescinuruer 


\/t^!4 ft rAAtlAA* A^AAAAnA^AnlA 

visit runcuon. aescenaents 


Xro 1 A7 

ire - 10/ 


rnvaic \ 


M 
IN 


TreVisitDesclnOrderBwd 


Visit function: descendents 


Tre -109 


Private 


N 


TreVisitDescPreOrder 


Visit function: descendents 


Tre -111 


Private 


N 


TreVisitlnOrder 


Visit function: in-order 


Tre - 113 


Private 


N 


TreVisitlnOrderBwd 


Visit function: in-order 


Tre- 115 


Private 


N 


TreVisitLeaves 


Visit function: leaves 


Tre -117 


Private 


N 


TreVisitParents 


Visit function: nearest parents first 


Tre -119 


Private 


N 


TreVlsitPreOfder 


Visit function: pre-order 


Tre -121 


Private 


N 


TreVisitRange 


Visit function: range 


Tre -123 


Private 


N 


TreVisitSuccPreOrder 


Visit function: all successors 


Tre -125 


Private 


N 


TreVisitSuccessors 


Visit function: successors 


Tre -127 


Private 


N 
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Page 


Scope Macro 


TskBasicAssert 


Foundation function 


N/A 




Ni 
in 


TskCondition 


Raise exception conditionally 


Tsk-2 




M 


TskDeinit 


Deinitialize instance 


Tsk-4 


r UUHC 


M 
in 


TskDefaultlnit 


Initialize instance with defaults 


Tsk-5 


Puhlir 


N 


TskExit 


Exit program with code 


Tsk-6 


Puhlir 


in 


TskExitWithMsg < 


Exit program and print message 


Tsk-7 


Pi ihlir 


M 
IN 


TskGetArgc 


Get mainQ argument count 


Tsk-8 


Pi thfir 


Kl 

IN 


TskGetArgv 


Get main() argument vector 


Tsk-9 


Pi thli/* 
ruQIIC 


M 
In 


TskGetExceptionCondition 


Return exception condition 


Tsk-10 


Di ihlrA 

rUDHC 


Kl 


TskGetExceptionRleName 


Return filename of exception 


Tsk-11 


Di thfi/* 
rUDIlC 


Kl 
In 


TskGetExceptionLineNo 


Return exception line number 


Tsk-12 


Pi ihli/* 
rUDHC 


Kl 
In 


TskGetExceptionType 


Return exception type 


Tsk-13 


Pi ihlif* 
rUDIIC 


Kl 
In 


Tsklnit 


Initialize instance 


Tsk-15 


Pi iKIm** 
rUDHC 


KJ 
In 


Tsklslnitialized 


Is the Task initialized 


N/A 


unuoc 


Kl 
In 


TskLogCond 


Raise exception conditionally 


Tsk-17 


Pi iHUr* 

ruunc 


Kl 
In 


TskMainLogCond 


Raise exception conditionally 


Tsk-19 


Di i Kl!/* 
rUDHC 


Kl 
In 


TskMainPreCond 


Raise exception conditionally 


Tsk-21 


Public 


N 


TskMainPtrCond 


Raise exception conditionally 


Tsk-23 


Public 


N 


TskMainRaiseException 


Raise exception unconditionally 


Tsk-25 


Public 


N 


TskNormalExit 


Exit task normally 


Tsk-27 


Public 


N 


TskOnException 


Establish exception handler 


Tsk-28 


Public 


N 


TskPopExceptionHandler 


Pop exception handler 


Tsk-30 


Public 


N 


TskPreCond 


Raise exception conditionally 


Tsk-32 


Public 


N 


TskPrintException 


Print description of exception 


Tsk-34 


Public 


N 


TskPropagateException 


Pass last exception 


Tsk-36 


Public 


N 


TskPtrCond 


Raise exception conditionally 


Tsk-38 


Public 


N 


TskPushExh 


Push the exception 


N/A 


Undoc 


N 


TskRaiseException 


Raise exception unconditionally 


Tsk-40 


Public 


N 



VtxAsGrfLel 


Return list element in graph 


Vtx 


-2 


Friend 


Y 


VtxAslnDII 


Return vertex as list of incoming edges 


Vtx 


-3 


Friend 


N 


VtxAsObj 


Return edge as object 


Vtx 


•4 


Private 


N 


VtxAsOutDII 


Return vertex as list of outgoing edges 


Vtx 


-5 


Friend 


N 


VtxClear 


Clear vertex 


Vtx 


-6 


Public 


N 


VtxConnectToGrf 


Connect vertex to graph 


Vtx 


-7 


Public 


N 


VtxCountln 


Count incoming edges 


Vtx 


-9 


Public 


Y 


VtxCountOut 


Count outgoing edges 


Vtx 


-11 


Public 


Y 


VtxOelnit 


Deinitialize the Vertex object 


Vtx 


-13 


Public 


N 


VtxDestroy 


Deinitialize Vertex object and free space 


Vtx 


-14 


Public 


N 


VtxDisconnectFromGrf 


Disconnect vertex from graph 


Vtx 


-15 


Public 


Y 


VtxFindOutEdg 


Visit search function: outgoing edges 


Vtx 


-17 


Private 


N 


VtxRndOutEdgaient 


Visit search function: outgoing edges 


Vtx 


-19 


Public 


N 


VtxGetClient 


Return client of vertex 


Vtx 


-21 


Public 


Y 
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Description 



Page Scope Macro 



VtxGetFirstln 

VtxGetFirstOut 

VtxGetGrf 

VtxInGrf 

Vtxlnit 

VtxSendDestroy 

VtxStackSetup 

VtxVisitEdge 

VtxVisitEdgeClient 

VtxVisitlnEdge 

VtxVisitlnEdgeCIient 

VtxVisitOutEdge 

VtxVisitOutEdgeaienl 



Return first incoming edge 
Return first outgoing edge 
Return graph 
Is vertex in graph 
Initialize the Vertex object 
Send message for vertex destruction 
Set up values for topsort 
Visit function: each edge 
Visit function: each edge 
Visit function: incoming edge 
Visit function: incoming edge 
Visit function: outgoing edge 
Visit function: outgoing edge 



Vtx-22 


Public 


Y 


Vtx-23 


Public 


Y 


Vbc-24 


Friend 


Y 


Vtx-26 


Public 


Y 


Vtx-25 


Public 


N 


Vtx-27 


Public 


N 


Vbc-28 


Friend 


Y 


Vtx-29 


Friend 


N 


Vtx-31 


Public 


N 


Vtx-33 


Friend 


N 


Vbc-35 


Public 


N 


VJx-37 


Friend 


N 


Vtx-39 


Public 


N 
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C+0 Datatypes 



Name 


Size 


Definition 


Usage 


Blk 


20/38 


struct Block 


Block class 


Block 


20/38 


struct Stock 


B/ocfc class 


Bool 


1 


char 


Boolean values* True or False 


Call 


N/A 


(Void) 


Overrides function returning value 


Char 


1 


char 


Text data 


Chr 


1 


char 


Text data 


Class 


16/26 


struct C/ass 


Class class 


ClientPtr 


2/4 


Void* 


Data Dointer to unknown tvoe 

"MIM WWII HWI IW Ul HW IWIVI 1 I J Uv 


CIs 


16/26 


struct C/ass 


Class class 

Www vlQww 


Const 


N/A 


const 


identifies function narampf prs which arp nnt mnriifiprl 

lUCllUIICw IUUwUV/11 pCUGlllCLClO VVIUWll CUv 1 IVl IMUUIMCU 


DateFormat 


2 


enum DateFormat 


Describe a disolav format for dates (spp JulianTime anri 
Sir/np) 


Dll 


6/12 


struct L/sf 


List class 


Opa 


8/10 


struct DvnamicArrav 


DvnamicArrav class 


DynamicArray 


8/10 


struct DvnaftiicArrav 


DvnamicArrav class 


Edg 


26/52 


struct Ecfcje 


Edoe class 


Edge 


26/52 


struct Edge 


Edije class 


ExceptionType 


2 


enum ExceptionType 


Type of exception generated (see Tasft) 


ExcFilter 


2/4 . 


Bool (*)( PTSK ) 


Function oointer to exceotion filters (see TasW 


Ext 


2 


enum ExceptionType 


Type of exception generated 


False 


N/A 


((Bool)O) 


Boolean False 

wvvivui i i aiwv 


Flags8 


1 


unsianed char 


Bit flaas (8) 


Flags 16 


2 


unsigned short 


Bit flaas (16) 

W*l IIUVJJ 1 1 VI 


Rags32 


4 


unsigned char 


Bit flags (32) 


uciicncr ir 




voiu 


Data pointer to unknown type 


Graph 


30/48 


struct G/ap/? 


Graph class 


Grf 


30/48 


struct Graph 


Graph class 


IntAddress 


2/4 


int/long 


Integer capable of holding a data address 


Jul 


4 


struct JulianTime 


JulianTime class 


JulianTtme 


4 


struct JulianTime 


Julian Time class 


LARGE DATA PTRS 


N/A 


N/A 


Defined if 4 byte data pointers are the default 


LARG E_FUNC_PTRS 


N/A 


N/A 


Defined if 4 byte function pointers are the default 


Largelnt 


4 


long 


Integers in the range [-2147483647:2147483647] 


Lei 


8/16 


struct ListElement 


ListElement class 


LINEJIO 


N/A 


_LINE_ 


Line number in file being compiled 


Ust 


6/12 


struct L/sf 


Ust class 


ListElement 


8/16 


struct ListElement 


ListElement class 


Mcl 


20/30 


struct MetaClass 


MetaClass class 


Mediumlnt 


2 


int 


Integers in range [-3276732767] 
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Name 


Size 


Definition 


Usage 


Mem 


1 


char 


Memory class 


Memory 


1 


char 


Afe/no/y class 


Message 


12/22 


struct Message 


Message class 


MetaClass 


20/20 


struct MetaClass 


MetaClass class 


MetaMessage 


8/14 


struct MetaMessage 


MetaMessage class 


MetaSuperClass 


12/22 


struct MetaSuperClass 


MetaSuperClass class 


Method 


2/4 


Void (*)( POBJ, ...) 


Function pointer (see Stock) 


MethodRetBool 


2/4 


Bool (*)( POBJ, ... ) 


Function (returning Bool) pointer (see BfocA) 


MethodRetlnt. 


2/4 


Mediumlnt(*)( POBJ, ...) 


Function (returning Mediumlnt) pointer (see Block) 


MethodRetDataPtr 


2/4 


PMEM (*)( POBJ, ...) 


Function (returning data pointer) pointer (see Block) 


MethodRetFuncPtr 


2/4 


PMTH (*)( POBJ, ... ) 


Function (returning function pointer) pointer (see Block) 


MethodRetPtr 


2/4 


Void * (*)( POBJ, ... ) 


Function (returning pointer) pointer (see Block) 


Mms 


8/14 


struct MetaMessage 


MetaMessage class 


MODULE_NAME 


N/A 


_FILE_ 


Name of file being compiled 


Msc 


12/22 


struct MetaSuperClass 


MetaSuperClass class 


Msg 


12/22 


struct Message 


Message class 


NULL 


2/4 


0 


Used to assign or return null pointers 


Obj 


2/4 


struct Object 


Object class 


Object 


2/4 


struct Object 


Object class 


PBLK 


2/4 


struct Block' 


Block pointer - does not require structure definition 


PCIO 


2/4 


struct ConsolelnputOutput * 


ConsolelnputOutput pointer - does not require structure 








definition 


PCLS 


2/4 


struct Class* 


Class pointer - does not require structure definition 


PDLL 


2/4 


struct List* 


Ust pointer - does not require structure definition 


PDPA 


2/4 


struct Dynamic Array* 


DynamicArray pointer - does not require structure 








definition 


PEDG 


2/4 


struct Ecfge * 


Edge pointer - does not require structure definition 


PGRF 


2/4 


struct Graph * 


Graph pointer - does not require structure definition 


PJUL 


2/4 


struct JulianTime * 


JulianTime pointer - does not require structure definition 


PLEL 


2/4 


struct UstElement* 


UstElement pointer - does not require structure definition 


PMCL 


2/4 


struct MetaClass * 


MetaClass pointer - does not require structure definition 


PMEM 


2/4 


Char* 


Mem pointer - does not require structure definition 


PMMS 


2/4 


struct MetaMessage * 


MetaMessage pointer - does not require structure definition 


PMSC 


2/4 


struct MetaSuperClass* 


MetaSuperClass pointer - does not require structure 








definition 


PMSG 


2/4 


struct Message* 


Message pointer - does not require structure definition 


PMTH 


2/4 


Void 0( POBJ, ... ) 


Function pointer (see Block) 


POBJ 


2/4 


struct 06/ecf* 


Object pointer - does not require structure definition. Also 


PSTR 






svnonvmous with a class Dointer of unknown tvoe 


2/4 


char* 


Null terminated text strings 


PTRE 


2/4 


struct Tree * 


Tree pointer - does not require structure definition 


PTSK 


2/4 


struct Task* 


Task pointer - does not require structure definition 


PVTX 


2/4 


struct Vertex* 


Vertex pointer - does not require structure definition 


Real 


8 


double 


Boating point (no range specified) 


Reg1 


N/A 


register 


Prioritized register allocation 



C+0 Datatypes 



Name 


Size 


Definition 

will *■ W w ■ ■ 


Usaae 


Rea2 


N/A 


reaister 


Prioritized reaister allocation 


Reg3 


N/A 


reaister 


Prioritized reoister allocation 

■ HV/IIUfcuU IvMlvlwl HII\A^IUWI1 


Rea4 


N/A 


reoister 


Prioritized reoister allocation 

1 IIVIIU&vU IvMlwlwl CUIWvCKIVI 1 


Reg5 


N/A 


register 


Prioritized reoister allocation 


Smalllnt 


1 


char 


Inteoers in ranae M 27:+ 1271 


Str 


1 


char 


Text data 


String 


1 


char 


Text data 


Task 


24/32 


struct Task 

Sj\l UVl « MW*» 


Tas/r class 


Tre 


16/32 


struct Tree 


Tree class 


Tree 


16/32 


struct Tree 


Tree class 


Tnje 


N/A 


((Bool)1) 


Boolean Tnje 


Tsk 


24/32 


struct Tasfc 


Task class 


ULargelnt 


4 


unsigned long 


Integers in the range (O.DxFFFFFFFF] 


UMediumlnt 


2 


unsigned int 


Integers in the range (OflxFFFF] 


USmalllnt 


1 


unsigned char 


integers in range [OiOxFF] 


Vertex 


22/44 


struct Vertex 


Vertex class I 


Void 


N/A 


void 


Function declarations 


Volatile 


N/A 


volatile 


(default) Identifies function parameters which are modified 


Vtx 


22/44 


struct Vertex 


Vertex class 
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Getting Started 



This section explains how to get C+O class libraries installed, what the 
directory structure looks like, source code organization, library organization 
and most important, organization of the C+O Documentation Set. 

Installing C+O class libraries is easy and you will be up in running quickly. 
However, hold back on the temptation of jumping to the install subheading, 
you're almost there! Once you have installed C+O, take a few minutes to 
familiarize yourself with the directory organization of C+O, you will probably 
want to view certain files as you're reading through the rest of the 
documentation. Also spend a few minutes thumbing through the manual. Get 
comfortable with its organization before you begin reading it in depth. 



Manual Organization 

C+O is divided into two books, the User's Guide and the Reference Manual. 
This is the User's Guide. The Reference Guide, is a concise description of all 
the functions supported by C+O. 

The diagram at the front of this manual, Class Inheritance Diagram, gives a 
picture of how C+O classes inherit behavior (this will make sense once you've 
read the rest of the User's Guide). 

The table, C+O Datatypes, lists all the #defines and typedefs used by C+O. 
Refer back to this table whenever you encounter a keyword or datatype name 
you are not familiar with while looking at C+O code or reading this manual. 

The table, Quick Reference: Class Functions, gives an alphabetical listing of all 
the functions in this library and a short description. This is handy as a fast 
way of locating a function. 

The User's Guide should be read first. This section you are reading now will 
help you install C+O and figure out where to look for other information. 

Section Two of the User's Guide, Writing a C+O Program, gives you a quick start 
on writing a program using C+O class libraries. You might want to read this 
section quickly to get an overview, read section Three, then come back to 
section Two. 

Section Three of the User's Guide, The Object-Oriented Approach to Developing 
Software, describes the concepts, methods, and techniques you will need to 
understand before writing substantial applications using C+O. Once you have 
read through this, we recommend that you examine the example source code 
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provided with C+O. The last subsection in this section, Test-Driving Classes, 
will tell you where to find that code and how to compile and link it. 

The Class Sununary is the place to find out what a class is used for, how it is 
implemented, what functions are available, and what other classes may be 
related. Spend some time reading through this section, this is where to go 
when you are looking for a particular class. 

Appendix A, Class Exceptions Reference, is a complete listing of all the 
exceptions which can be generated by C+O. It is organized by function name. 
Within each function it lists the file name and line number where the exception 
was detected along with a message describing what the exception means. The 
file name and fine number is what will be displayed on your screen when 
running a C+O program and an exception is detected and trapped by an 
exception handler. You will refer to this section often as you begin writing your 
first C+O program. 

Once you have made it through the User's Guide, you. will be ready to go 
through the Reference Manual. The Reference Manual consists of the Class 
Inheritance Diagram, the Quick Reference, the C+O Datatypes Table, and the 
Class Reference. The first three items are the same as described for the User's 
Guide. 

The Class Reference is where to go to find out the details of a particular 
function. Each function occupies a minimum of one page and often two. 
Where useful, diagrams or examples are provided. This section is arranged 
alphabetically by function name. 



Installing C+O Class Libraries 

To install C+O you should have 2.0 Megabytes of hard disk storage available. 
If you have the source code option, you will need a total of 3.0 Megabytes. 

While it is possible to install C+O class libraries on a floppy disk, it is not 
recommended. We cannot recommend a floppy disk organization that will work 
for everyone so if you are intent on installing this on a floppy system, you will 
have to manually copy files over to your working disks. The install procedure 
provided assumes that all files can be copied onto a single disk. 

To install C+O on your hard disk system, change your current drive to A and 
type INSTALL followed by the fully qualified path you wish to install under. We 
recommend installing it to the directory COBJECTS. 



C:> A: 

A:> INSTALL C:\COBJECTS 
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C+O will create the necessary directories and copy its files, prompting you to 
change disks when appropriate. You may abort the install at any time and 
restart it if need be. C+O is not copy protected and will not put any hidden 
files on your disk. 

For convenience in referring to the install directory, we assume you have 
installed C+O to C:\COBJECTS. If you installed to another disk or directory, 
just substitute the name you installed to wherever we mention C:\COBJECTS. 

INSTALL creates four subdirectories under C:\COBJECTS. These directories 
are: 



LIB Microsoft Library files (.LIB extension) containing C+O object code for 

different memory models and debug and production executables. 

INC C+O include files (.H extension) used for compiling C+O programs. 

TST C source files (.C extension) which can be compiled to test C+O 

functions and demonstrate how to use C+O classes. Also includes link 
files (.LNK extension) and batch files (.BAT extension) for compiling and 
linking. N 

SRC C source files (.C extension) which implement the C+O classes. This 

directory is created only if you have purchased the source code option. 
Also includes batch files (.BAT extension) for compiling C+O libraries. 



Directory structure of C:\COBJECTS 



Source Code Organization 

The source code provided with C+O consists entirely of C code, namely .C and 
.H files. C+O source code is divided into classes. Each class has a long name 
and a three letter abbreviation. The abbreviation, or prefix is used in naming 
functions, naming variables, and naming the source code files. C+O source 
code has the following naming convention and associated meanings. The table 
shown uses a hypothetical class with the prefix Xyz. 
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xyz.h This file holds the structure declaration for the class whose abbreviation 
is Xyz. This file is included if you need the structure definition of Xyz. 

xyzmac.h This file holds the function declarations and macros for the class Xyz. 

This file is included if you need to perform functions against an object of 
class Xyz. It automatically includes xyz.h. 

xyzcls.h This file holds any function declarations and macros which are private to 
the class. It also holds the MetaClass definition of the class if it has one. 
This file is included only by the C file which defines the class Xyz 
functions (xyz.c). 

xyz.c This file holds the function definitions for Xyz. Each function in this file is 

prefixed with Xyz and takes a pointer to Xyz as its first parameter. These 
files are included only if you have purchased the source code option. 



C+O Source Code Organization 

Library Organization 

C+O comes with precompiled object code organized into object libraries. 
Libraries are provided for several different memory models, including small, 
medium, large and compact. 

Libraries are also provided for creating debugging and production executables. 
This allows you to test your code with the larger, slower debug libraries which 
will help you catch many bugs before they cause a problem. Then when you 
are ready to create a so-called production executable, you can link with the 
production libraries which are much faster and smaller, with all the debugging 
code removed. The following list describes each library provided. 



cobjds.lib Small memory model. Debug version, 

cobjdm.lib Medium memory model. Debug version, 

cobjdl.lib Large memory model. Debug version, 

cobjdc.lib Compact memory model. Debug version, 

cobjps.lib Small memory model. Production version, 

cobjpm.lib Medium memory model. Production version, 

cobjpl.lib Large memory model. Production version, 

cobjpc.lib Compact memory model. Production version. 



Libraries supplied with C+O 
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Test-Driving Classes 

C+O comes with a set of demo programs which allow you to test C+O classes in 
a controlled environment. You may want to study this code to understand 
better how to use C+O class libraries. 

To run the test programs you must first compile and link them. Batch file 
procedures exist in the C:\COBJECTS\TST directory for compiling and linking 
all the test programs. Each test program uses one or more classes. The 
following table identifies the test programs provided and what they do. 



tstblk.c 


Demonstrates the Block class. 


tstcls.c 


Demonstrates the Class class and to a lesser degree Object class. 


tstdll.c 


Demonstrates the List class. Should also see tstlel.c which 
demonstrates ListElements. 


tstdpa.c 


Demonstrates the DynamicArray class. Also shows example of abstract 
superclass and message sending. 


tstgrf.c 


Demonstrates the Graph, Vertex and Edge Classes. Also provides a 
simple example of how an Adventure game might be set up using these 
classes. 


tstjul.c 


Demonstrates the JulianTime class. 


tstlel.c 


Demonstrates the ListElement class. Should also see tstdll.c which 
demonstrates the List class. 


tstmcl.c 


Demonstrates the MetaClass and to a lesser degree, the MetaMessage 
and MetaSuperClass classes. 


tstobj.c 


Demonstrates the Object class. 


tststr.c 


Demonstrates the String class. 


tsttre.c 


Demonstrates the Tree class. 


tsttsk.c 


Demonstrates the Task Class (mainly exception handlers.) Also see 
tsttskl.c, tsttsk2.c, and tsttsk3.c 



Demonstration and Example Source Code 
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In this section, you will learn how to write, compile, and link a C+O program. 
Before beginning, it is recommended that you have already read section Three, 
The Object-Oriented Approach to Developing Software. This section is printed 
first for those who can't wait to dive in! 



Anatomy of a C+O Program 

In this section we will take you through the steps needed to compile and link a 
program using C+O classes. 

Let's start by creating the shell of a C+O program. The main thing we want to 
show here is that all C+O programs need to set up at least one exception 
handler near the beginning of the program. The reason for this is that C+O 
may detect a bug while running. Rather than try and handle it locally, it 
jumps back up to the exception handler which typically prints the exception 
information and then exits the program (after some cleanup we assume). 
Thus, even a buggy program can be well-behaved. In general all C+O programs 
need to be set up in this fashion. Example 1 shows the mainO function for a 
C+O program. 



#include "cobjects.h" 
#ifndef TSK 
#include "tskmac.h" 
#endif 

static PSTR ModuleName = MODULE_NAME; 

int main( int argc, char **argv ) 

TskDefaultlnit( TskMain, argc, argv ); 

if ( TskOnException( TskMain ) ) { 
TskPrintException( TskMain ); 
return TskExit( TskMain, 1 ); 



/* Application logic goes here... 7 
TskNormalExit( TskMain ); 



Example 1 - Typical mainO function for C+O program 
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All C+O programs need to include the header file "cobjects.h". This file defines 
many typedefs used by C+O classes. These typedefs help make C+O libraries 
more portable than they otherwise would be. C+O libraries do not use any of 
the built-in types provided by C directly. All fundamental datatypes used by 
C+O are defined as typedefs in this file. For example, Smalllnt, Mediumlnt, 
and Largelnt are int typedefs for 8 bit, 16 bit and 32 bit quantities 
respectively. String is a char, and PSTR a pointer to char. The table at the 
beginning of this manual, C+O Datatypes Table, explains the different 
datatypes and keywords defined by C+O. 

Next let's look at the code fragment immediately following the inclusion of 
cobjects.h. This code fragment is how we include an H file in C+O programs. 



#ifndef TSK 
#include "tskmac:h" 
#endif 



Example la - Conditional inclusion of an H file 

Each class header file defines a macro when the file is included. Because C+O 
headers also include class headers for other classes, we would like to make 
sure we only read in those files once. Hence, we always conditionally include 
files based on a macro being undefined. The following table shows what 
naming convention is used for various H files: • 



xyz.h XYZ_H 
xyzmac.h XYZ 
xyzcls.h XYZCLS 



Table lb - Conditional include variables 

Moving back to our original Example 1, we have included tskmac.h. This file 
will automatically include tsk.h. We include this file because we will be calling 
Task functions. In general, whenever we want to access one or more functions 
that belong to a class, we must include the xxxmac.h header for that class 
(where xxx is the class prefix) . 

Next we define the static variable ModuleName. This variable is referenced by 
assertion macros. MODULE_NAME is the name of the C file being compiled. 



static PSTR ModuleName = MODULE_NAME; 
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Assertion macros are used to check the logic of programs. If the condition 
specified in an assertion fails, an exception is generated and generally a 
message displaying the filename and line number where the exception was 
generated appears. We will get back to exception handlers in a minute. By 
using a variable instead of a string literal (as Microsoft's implementation of 
assert does), we do not repeatedly store the same string in the constant data 
segment of our executable. This can be a significant chunk of memory when 
you use lots of assertions as C+O does. 

Next, after the declaration of mainO, we want to initialize a Task object. The 
Task class automatically declares a global Task instance called TskMain. 



TskDefaultlnit( TskMain, argc, argv ); 



Example Id - Initializing TskMain 

The Task class is used to model the C+O program itself. There is typically only 
one instance of a Task in a running program. This would be TskMain. 

The Task class is important to all C+O programs because it defines the 
exception handling mechanisms. C+O relies heavily on exception handlers to 
signal problems in using C+O libraries. C+O is very good at detecting invalid 
pointers, memory corruptions, and uninitialized data. 

Once a Task has been initialized (preferably TskMain), we can set up an 
exception handler. 



if ( TskOnException( TskMain ) ) { 
TskPrintException( TskMain ); 
return TskExit( TskMain, 1 ); 



Example le - Setting up an exception handler 

An exception handler is set up by calling TskOnException. The return value 
from TskOnException is 0 when the handler is set. However, if an exception is 
raised, even if it is several layers of function calls below main, then control is 
transferred to the statements inside the if statement. It is then up to these 
statements (the exception handler) to determine how to process the error. 
TskOnException behaves very much like the Ansi C function setjmpfj and in 
fact is implemented using setjmpQ. 
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The particular exception handler shown here will print a message displaying 
the filename and line number where the exception was detected and then exit 
the program. 

Finally, the statements following the exception handler are the statement which 
make up your program. When the program is ready to exit it should call 
TskNormalExitO. Please take a look at the Task Class Summary for a more 
complete discussion of the functions discussed here and others which will be of 
interest. Also, be sure and look at the example Task code provided. It 
demonstrates exactly how exception handlers behave under a variety of 
circumstances. 

Creating a Class of Your Own 

To use some C+O classes, you must build a new class on top of an existing 
one. These classes include: ListElement, List, Tree, Vertex, Edge and Graph. 
For more information on how to do this, read section Three, The Object- 
Oriented Approach to Developing Software, and also study the related example 
code. 

Other classes, specifically JulianTime, String, DynaiiiicArray, and Memory are 
usable as is without prior setup. However, the principles of encapsulation still 
apply and you may wish to create a class which incorporates one or more of 
these classes. 

Finally, several classes exist for supporting the object-oriented functionality of 
C+O classes and for supporting exception handling. These classes include: 
MetaClass, MetaMesage, MetaSuperClass, Class, Object, Message, Block, and 
Task. You will be using some functions from almost every one of these classes 
in building a C+O program so it is important you understand their role and 
usage. It is doubtful you will want to extend these classes, but should you 
wish to, please try and keep your extensions upwardly compatible — after all, 
these classes provide the foundation for object-oriented programming in all 
C+O class libraries. 

For examples of using classes, please refer to the example code provided. A 
separate program is provided for most classes. 

Because many C+O functions are macros, you should avoid calling functions 
with parameters which have side effects such as the pre or post increment 
operators. 

Debug and Production Libraries 

C+O provides two kinds of libraries, debug and production. The major 
difference between them is that the debug library includes lots of argument 
checking whereas the production library does not. Another difference is that 
the production libraries use C+O macros and the debug libraries use the 
function equivalent. 



Two -4 



Writing C+0 Programs 



When you are first testing a program that uses C+O classes you will want to 
compile and link it with me debug libraries so as to catch any error of use. 
When you have debugged your program, you can recompile it for the 
production libraries and the resulting executable will be much smaller and 
much faster. 

You must always compile your code appropriately for the particular C+O 
library you intend to link with. This means you must choose an appropriate 
memory model and you must define the COBJ_PRD flag (preferably with 
compiler startup flags) if you are going to link with the production libraries. 
Structure sizes are different for debug and production versions so it is 
imperative that you not mix these two styles. 

Compiling 

Compiling a C+O program is the same as compiling any other. You may use 
whatever compiler switches you want but you must be aware of the following 
things. 6 

First, the C+O libraries are compiled without packing structure members (/Zp 
option). Compiling your code with this option will cause problems. 

C+O class libraries are compiled for the alternate floating point math package. 

You must define the identifier COBJ_PRD when you wish to produce your final 
production executable. If you are intending to link with a debug library, do not 
define this switch. In either case, your entire program must be compiled with 
or without this flag defined. The following example shows a compile line for 
compiling for debug. 



C:>CL /D COBJ_PRD /AL /W3 /Ox /Fpa 10 /I C:\COBJECTS\INC XYZ.C 



How to Compile for Production Code, Large Model 

The following example shows the same compile line, but this time generates 
production code. 



C:>CL /AL /W3 /Ox /Fpa /C /I C:\COBJECTS\INC XYZ.C 



How to Compile for Debug Code, Large Model 

Should you need C+O libraries compiled with other options, memory models, or 
floating point packages, please contact Objective Systems. We can provide you 
with these libraries at little or no cost. 
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Linking 

You may link C+O programs with the standard linker provided by Microsoft. If 
you have compiled your code with the preprocessor variable COBJ_PRD, you 
must link with the production libraries (COBJPx.LIB where x is the memory 
model letter). Otherwise link with the production libraries (COBJDx.LIB). The 
following example shows how to link a C+O program compiled for debug and 
the large memory model. 



C:>LINK XYZ,XYZ,XYZ,\COBJECTS\LIB\COBJDL \MSC\LIB\LLIBCE; 



Debugging 

You may use whatever debugger you are using now to debug C+O programs. 
Codeview is our preference. C+O libraries are not compiled with any debug 
information. If you have the source code option, you may of course recompile 
them with this option. 

We recommend compiling and linking with our debug libraries when you are 
first testing a C+O program. The C+O debug libraries trap many bugs before 
they can cause a problem. When a bug is detected an exception is generated, 
causing an exception handler to be invoked. This will typically result in the 
program displaying the filename and line number where the exception was 
detected. You will want to use Appendix A to determine the cause of the 
exception. 

Because many C+O functions are macros, you should avoid calling functions 
with parameters which have side effects such as the pre or post increment 
operators. 



Optimizing 

Optimizing your C+O program is as simple as recompiling it with the 
production compiler flag set and linking with the production libraries. Many 
C+O functions are written as macros and the production compile flag 
COBJ_PRD enables these macros. Most or all of the parameter checking to 
C+O functions is disabled as well when this flag is set. 

Because many C+O functions are macros, you should avoid calling functions 
with parameters which have side effects such as the pre or post increment 
operators. 
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Introduction 

Much has been written lately about object-oriented programming (OOP) and 
object-oriented programming languages (OOPLs). When we think of object- 
oriented programming, we probably think of SmallTalk, G++ or LOOPS. 
However, all of the concepts rigorously applied in those languages can be 
applied (with a little extra effort) to commercial languages such as C. And by 
applying those concepts, we can attain the productivity benefits promised by 
advocates of object-oriented programming while retaining the benefits of 
programming in C. 

C+O (Classes + Objects) class libraries are the first commercial products 
designed to apply object-oriented programming techniques specifically for the C 
language without requiring a pre-processor or interpreter. C+O class libraries 
are efficient and can be used to deliver commercial quality products. C+O is a 
tool for increasing your productivity by decreasing the amount of general 
purpose code you must write (and debug) for every program. It is also a tool for 
allowing you to create your own libraries of reusable code. C+O has extensive 
debugging facilities for helping you track down problems. 

Of course, you may already be building "black box" code. Code which is 
insulated from other parts of a program and has a very well defined interface. 
In this case, you already will be familiar with some of the concepts provided by 
C+O class libraries. C+O offers a standard way of designing and building such 
black boxes. Its comprehensive and rich set of tools and engineering 
techniques allow you to build more flexible black boxes than ever before. 

In this section, you will learn the fundamentals of how to create and use 
reusable code with C+O class libraries. The examples presented here are all 
coded using C+O stylistic and naming conventions. After reading this section 
and working through the examples, you will have the basic knowledge needed 
to apply C+O object-oriented programming concepts to real problems, taking 
advantage of C+O reusable code libraries. 

You may want to look at and run the demo code provided with C+O as a means 
of further enhancing your understanding of the concepts presented here. 
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Background 

The general misconception regarding object-oriented programming is that it is 
of use only for designing user interfaces or graphics packages. However, 
object-oriented programming techniques are beneficial for building any kind of 
software. Benefits include faster implementation (due to reusability), greater 
reliability (due to reusability) and better maintainability (due to encapsulation 
and dynamic binding). In short, object-oriented programming, or OOP is about 
finding better ways to modularize software while making it more reusable. 

Part of the problem in getting the word out about OOP is that to date, most of 
the work done involving OOP was written in Smalltalk. The reason that this is 
a problem, is because the terminology associated with Smalltalk is completely 
foreign to the terminology we are accustomed to from using commercial 
languages. The result is that when someone from the object-oriented 
community tries to explain to us the workings of object-oriented programming, 
it's very much like a first lesson in French ~ the teacher stands up mere 
talking away and we're sitting there wondering what's going on. 

One other problem is the common perception that object-oriented programnung 
implies high-overhead programming. Smalltalk has done much to contribute 
to that perception. It consistently applies OOP techniques to solving problems 
with about the same finesse as using a .44 magnum to kill a fly. To keep OOP 
a tool we can use efficiently, we must have an arsenal of OOP techniques 
equivalent in range from flyswatters to cannons ~ and we must have the 
wisdom to know which tool is right for the job. 

What makes C+O different from Smalltalk and many other object-oriented 
languages and extensions, is that first, we demystify the language of object- 
oriented programnung and place it firmly back in the hands of the people 
building commercial products. Second, we provide a range of object-oriented 
solutions which keep the amount of program overhead and program complexity 
in line with the benefits they produce. In this way, you can apply the object- 
oriented solutions which best fit your particular problem. 

Before moving on, we should mention how C++ fits together with C+O class 
libraries. First of all, the benefit to using C+O class libraries is not the fact 
that it is object-oriented. The benefit to using C+O class libraries is that you 
decrease your programming effort by reusing its code. It is therefore our 
intention to provide C+O class libraries for standard-setting languages. If C++ 
becomes something of a standard, as we expect it will, we will port C+O to that 
language. When we do, we will fully adopt the object-oriented paradigms 
provided by that language. Currently however, C++ is still somewhat in a state 
of flux and their are very few vendors providing C++ compilers/pre-processors. 

C+O was developed by Objective Systems over the last two years. It was 
developed specifically to allow us to create highly reusable code which was 
efficient enough to be used in commercial product development. 
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Classes 

In explaining the object-oriented precepts behind C+O, we will always keep the 
discussion centered around the C language. We will borrow many terms from 
the OOPL vocabulary but define them in terms which a C programmer can 
quickly comprehend. It is therefore a prerequisite that you have a solid 
knowledge of C programming. It is not a prerequisite to have a knowledge of 
object-oriented programming although it will help if you have some basic 
familiarity with the subject. 

The first thing to consider are classes. A class is the fundamental unit of 
programming in object-oriented languages and we adopt the concept for C+O. 
Example 1 snows the class Point. 



struct Point { 
Mediumlnt x; 
Medium I nt y; 

}; 

typedef struct Point Pnt; 
#define PPNT struct Point * 

Void PntSetXY( PPNT, Mediumlnt, Mediumlnt ); 
Mediumlnt PntGetX( PPNT ); 
Mediumlnt PntGetY( PPNT ); 

#ifdef PNT.MACROS 

#define PntGetX( pPnt ) ((pPnt)->x 

#define PntGetX( pPnt ) ((pPnt)->x 
#endif 



Example 1 - Point Class 



A class is defined as a structure and functions which manipulate and access 
that structure. Another word we use interchangeably with function is method. 
Only the functions (methods) associated with a class can access the structure 
members directly. Functions not belonging to a class must rely on the 
functions provided by that class for manipulating and accessing the structure. 
If we could directly represent this in C, it would be as if functions were always 
declared as part of a struct declaration. Instead, we rely on source code 
organization and naming conventions to help reiterate the relationship. This 
property of not allowing direct access to structures other than through 
methods belonging to the class is called encapsulation. 
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Referring back to Example 1, we show how the Point class would be defined in 
C+O. The Point class consists of a struct declaration for Point and some 
functions with the names prefixed by Pnt. Sometimes we define macros for 
simple functions. We also define a typedef for Point called Pnt (always a three 
character abbreviation) and a #define for a pointer to struct Point called PPNT. 
C+O uses this naming convention consistently throughout its classes. Finally, 
we always require that the first parameter to a Point function a pointer to 
Point.* From the perspective of source code organization, we would declare the 
Point structure in a file called "pnt.h", the function declarations and (optional) 
macros in "pntmac.h", and the function definitions in "pnt.c". This makes it 
very simple to locate the definition or declaration of an item based on its prefix. 

You have now learned the single most important concept used in object- 
oriented programming. Simply, that programs are structured into classes. 
Notice there is no magic in this, it is simply a design decision which reaps 
certain benefits. Namely, it makes programs more modular and in general 
easier to understand. Programs in which functions directly access the 
implementation of more than one structure are inherently less modular and 
the code less reusable. Another benefit of classes is that it is much easier to 
change the implementation of a class without affecting a potentially enormous 
and unknown amount of code. As long as the external interface (and 
semantics) provided remains the same, other classes will not be affected. 

Of course, there is nothing preventing a C programmer from violating the class 
concept (unlike most OOPLs). C won't even warn you that a class is being 
violated. It is a matter of discipline. You must believe that its important not to 
violate the class rule and that certain benefits are provided by doing so. While 
we believe you will get more out of C+O by following this convention, it is up to 
the individual programmer to decide. 

Before continuing, it is important to note one more thing, namely, that there is 
an important psychological benefit to the class concept Namely, it gets us 
thinking about building a program in terms of parts. Once we get into this 
mind-set, it is natural for us to want to reuse those parts in other programs or 
even within the same program. This is at the heart of what C+O is about. 

Now that we understand what a class is, we will interchangeably refer to it as a 
structure, in deference to our C background, but keeping in mind that we still 
associate with it a particular set of functions for manipulating that structure. 
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Objects 

A structure declaration has no existence of its own in a running program. Only 
when we declare variables of some structure type can we assign or retrieve 
values from the structure. We must also name the particular variable since 
there may be more than one variable declared with that same type. We refer to 
the memory allocated to a variable, whether it be external, static, automatic, or 
dynamic, as being an instance of that structure. We also refer to instances as 
objects. Example 2 shows some Point objects. 



Point x; r An instance of Point class named x 7 

Pnt y; /* A Point object named y */ 

PPNT pPnt; I* Pointer to a Point object named pPnt 7 



Example 2 - Point Objects 

This is the second most important thing to understand about object-oriented 
programming. Namely, that while our program is structured in terms of 
classes, when it is running, it is objects which we are manipulating. 

Let's continue with the Point example and fill in the functions for manipulating 
Points. Example 3 shows two of the Point methods being defined. In C+O, 
methods always manipulate pointers to objects of the class. 



Void PntSetXY( PPNT pPnt, Mediumlnt x, Mediumlnt y ) 

pPnt->x = x; 
pPnt->y = y; 



Mediumlnt PntGetX( PPNT pPnt ) 
return pPnt->x; 

} 



Example 3 - Point Methods 

We have now seen a complete class definition. Our example shows only a 
small number of functions for class Point. This is how most classes start out. 
Over time, you and others will add more functions, rounding out a class 
implementation. 
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Designing with Class 

One of the interesting things about classes, is how they force us to think about 
where to add a function, what types of parameters to pass, how to name it, 
what effects it will have, and so on. In other words, classes provide a structure 
for thinking about how we design and organize code. This shift of thinking 
from traditional programming tends to inspire better function and program 
design, 

A couple of words are in order regarding good class design and good design of 
functions belonging to a class. First, the class structure should reflect a single 
entity, or a single relationship. For instance a spreadsheet program would 
have classes called Cell, Formula, and Spreadsheet, among others. If you find 
yourself designing a class which ends up seeming like two or more things, 
break it apart! Any small increase in overhead will be well worth the resulting 
simplified program architecture. Look for application specific classes which 
can be broken into a non-application specific part and an application specific 
part. The former you may be able to reuse in another program. 

When designing functions, have lots of little, simple functions which perform a 
single act, rather than large functions which do many tasks. If you name your 
functions according to the task the perform, as we do in G+O, you will find that 
overly complex functions cannot be named in under 32 characters or that the 
names become rather bizarre, sounding more like a run-on sentence than a 
verb. This advice has saved us from bad design decisions on many occasions. 

Another good rule of thumb are functions which take large numbers of 
parameters. These are often suspect of being amenable to decomposition. 

Finally, and we cannot overstate this, avoid writing functions which rely on 
data other than the parameters being passed into the function. In other words, 
minimize or eliminate global variables. One way to think about this is what if 
you had to pass every global variable you accessed in your function as a 
parameter instead. Would it seem unwieldy? If so, then you've got a function 
which is side-effect heavy. 
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Foundation 

Everything we are going to tell you from here on out concerns two related 
things: how to build classes on top of other classes and how to make instances 
of those classes communicate with one another. You can think of this as the 
glue which binds classes together or the grease which keeps them from 
grinding against each other. Both analogies are relevant. 

The mechanisms which allow objects to communicate are crucially important 
to the success of an object-oriented system. The reasons are this: if 
communication between objects is slow, then the system is doomed to be slow. 
If communication mechanisms are limited, then the flexibility of the system is 
compromised. C+O uses a variety of mechanisms to allow objects to 
communicate. None of them are "slow". 

The mechanisms which allow classes to be built on top of other classes are also 
extremely important. For instance, if you can only build a class based on one 
other class (as many OOPLs provide), you are limited to making more and more 
refined versions of the same class. On the other hand, if you can build new 
classes from any number of other classes as C+O provides, you have a much 
more powerful system. 

Example 4 shows how a class can be built from other classes. 



struct Rectangle { 
Point origin; 
Point extent; 

}; 

typedef struct Rectangle ; 
typedef struct Rectangle Ret; 
#define PRCT struct Rectangle *; 

Void RctSetOriginAndExtent( PRCT, PPNT, PPNT ); 

Void RctGetSizeX( PRCT ); 

Void RctGetSizeY( PRCT ); 

Void RctGetOrigin( PRCT, PPNT ) ; 

Ret R = {0}; 



Example 4 - Rectangle Inherits from Point Twice 



In its simplest form, building a class from another class is simply a matter of 
including the structure of one inside the other. Referring to Example 4, we say 
that the Rectangle class inherits from the Point class. When a class includes 
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This example Immediately begs the question of how does one communicate 
between instances of classes. Using Example 4, the Rectangle R can be 
thought of as actually being three objects: the Rectangle R, the Point Rorigin, 
and the Point Rextent. 

First, because Point is defined independently of Rectangle or any other class, 
there is no way Rorigin and Rextent can communicate directly. 
Similarly, neither Point object can communicate with R since they are unaware 
of R as well. 

Therefore, it is up to R to communicate to with both Points. Thus we have 
what we call simple inheritance. Put another way, Point has no mechanisms 
or functions for communicating with structures which include it as a struct 
member. 

Before we go any further, we need to define some terminology for the 
relationship of Rectangle to Point and Point to Rectangle. We call Rectangle the 
subclass of Point and Point (each one) the superclass of Rectangle. This 
terminology is carried over (and extended) from Smalltalk. 

These terms may seem reversed and contrary to common sense. The usage 
seems to be derived from the fact that in Smalltalk there is only one superclass 
which a class can be built upon. Thus a subclass is viewed as being a more 
restricted form of its superclass. Multiple-inheritance certainly changes this 
perspective, however we will stick by Smalltalk's definition of these terms 
rather than make matters worse by reversing them. In any case, we prefer to 
call Rectangle the client of Point and Point a server to Rectangle. 

We need to make clear that a structure cannot inherit from a structure which 
it points to, only one which is included as part of its definition. Thus, if 
Rectangle were defined as in Example 5, it would not be considered to inherit 
from Point. The reason for this is that inheritance is defined as being a 
contiguous extension of one class instance from another. There can only be 
one instance of a subclass for an instance of a superclass. In Example 5, 
changing the pointer values of origin or extent would be to change the 
particular instances they inherit from. To allow otherwise would invite chaos. 



struct Rectangle { 
Point 'origin; 
Point *extent; 

}; 



Example 5 - Rectangle Does Not Inherit From Point 
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Unlike some object-oriented languages, we take the view that a subclass may 
not "look inside" its superclasses). In our example. Rectangle R may not 
directly access the contents of either Point (origin or extent). Rectangle R must 
use the functions provided by the Point class when accessing R. origin or 
Rextent. Of course there is no way for the compiler to enforce this, you must 
simply believe this rule important enough to follow. The rationale for this 
decision is simply that we don't believe there is any benefit to allowing a client 
to have direct access to its servers. The black box approach is much safer. 

Example 6a shows the wrong way for Rectangle to communicate with Point. 
Example 6b shows the correct way. 



Medium Int RctGetSizeX( PRCT pRct ) 
return pRct->extent.x - pRct->origin.x; 



Example 6a - Violates Encapsulation Rule 



Mediumlnt RctGetSizeX( PRCT pRct ) 

return PntGetX( &pRct->extent ) - PntGetX( &pRct->origin ); 



Example 6b - Encapsulation Rule Satisfied 
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Finally, Example 6c goes one step further and creates a new Point function 
PntGetDiffX. This is in the spirit of creating functions which may be likely be 
reused somewhere else. One must always keep in mind that every loop, every 
calculation, every process defined may be of value to you or someone else at a 
later time. Coding the function inside of a different class helps no one. 



Mediumlnt PntGetDiffX( PPNT pPntl , PPNT pPnt2 ) 
return pPntl ->x - pPnt2->x; 

} 

Mediumlnt RctGetSizeX( PRCT pRct ) 

return PntGetDiffX( &pRct->extent, &pRct->origin ); 



Example 6c - Maximizes Reusability by Creating New Point Method 
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Advanced Inheritance 

More complicated structures can be created which require more sophisticated 
styles of interplay than previously described. Example 7 shows the classes 
Node and BinaryTree (for a complete discussion of binary trees, see Knuth, The 
Art of Computer Programming, Volume 1). 



#define PBIN struct BinaryTree * 
#define PNOD struct Node* 

struct BinaryTree { 
Object obi; 
PBIN left; 
PBIN right; 

}; 

typedef struct BinaryTree BinaryTree; 
typedef struct BinaryTree Bin; 



struct Node { 
Object obj; 
PSTR name; 
BinaryTree bin; 

typedef struct Node Node; 
typedef struct Node Nod; 



Example 7 - Node and Binary Tree Classes 

A binary tree has left and right pointers to other binary trees. The left subtree 
is shown as being connected to its branch with a vertical arrow, the right 
subtree is shown as being connected to its branch by a horizontal arrow. 

In Example 7, Node is inheriting BinaryTree. The inclusion of Object structure 
members in both classes signifies a more complex form of inheritance than we 
have encountered before. It is a requirement for this type of inheritance that 
the Object structure members be the first member of the structure. It is the 
Object class which gives other classes their object-oriented characteristics. 
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Example 8 shows how we create new instances of type Node with the function 
_NodNew. We prefix the function name with an underscore to easily identify it 
as a Node function which does not take a Node pointer as its first argument. 
The function Binlnit is used to initialize an instance of Bin and should always 
be the first Bin function called after allocating memory for the object. 



Void Binlnit( PBIN pBin ) 

pBin->left ■ pBin->right = NULL; 



PNOD _NodNew( PSTR name ) 

{ PNOD pNod; 

pNod = (PNOD) ClsNewObject( NodCIs ); 
Binlnit( &pNod->bin ); 

pNod->name = malloc( strlen( name ) + 1 ); 
cpystr( pNod->name, name ); 



{ 

a = _NodNew( "a" );b = _NodNew( "b" ); 
c - _NodNew( "c" ); d = _NodNew( "d" ); 
e = _NodNew( "e" );f = _NodNew( T ); 
g = _NodNew( "g H ); h = _NodNew( "h" ); 



Example 8 - Creating Nodes 

The variable NodCIs (referenced in _NodNew) is a pointer to an object of type 
Class and is initialized soon after the program starts up. Class objects are 
used to create and initialize instance of classes in C+O. Later we will show you 
how to create the Class instance NodCIs. The function ClsNewObject allocates 
memory for an object as specified by NodCIs. 
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Now that we've created some Nodes, we need functions to manipulate them. 
Example 9 shows some BinaryTree methods for connecting up BinaryTrees to 
the left and right subtrees. It also shows the equivalent Node functions. In 
effect, we are demonstrating how Node is inheriting some behavior (functions) 
from BinaryTree. The Node functions NodSetLeft and NodSetRight would 
typically be defined as macros for efficiency. 



Void BinSetLeft( PBIN pBin, PBIN pBinLeft ) 
pBin->left = pBinLeft; 



Void BinSetRight( PBIN pBin, PBIN pBinRight ) 
pBin->right = pBinRight; 



Void NodSetLeft( PNOD pNod, PNOD pNodLeft ) 
1 BinSetLeft( &pNod->bin, &pNodLeft->bin ); 



Void NodSetRight( PNOD pNod. PNOD pNodR ) 
1 BinSetRight( &pNod->bin, &pNodR->bin ); 



NodSetRight( a, b ); 
NodSetRightj b,c); 
NodSetLeft( a, d ); 
NodSetLeft( d, e); 
NodSetRight( e, f ); 
NodSetLeft( c, g ); 



Example 9 - Node Inherits Behavior From BinaryTree 
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For Node to communicate with BmaryTree is a relatively trivial matter as we 
have seen. But now, we need a way for BmaryTree to communicate back to 
Node if we are to use Binary Tree access methods. Example 10 shows the 
problem. 



PBIN BinGetLeft( PBIN pBin ) 
return pBin->left; 



PNOD NodGetLeft( PNOD pNod ) 

return BinGetLeft( &pNod->bin, NodOffset ); 



Example 10 - Wrong Way to Implement NodGetLeft 
In Example 10, BinGetLeft returns a pointer to a BinaryTree, not a Node. 
Therefore the implementation of NodGetLeft is incorrect, it is returning a 
BinaryTree pointer instead of a Node pointer. What we need is a mechanism 
by which Bin can return to us Node pointers. Example 1 1 shows how we do 
this with C+O. 



POBJ BinClientGetLeft( PBIN pBin, Mediumlnt offset ) 
return ObjGetClientOrNull(&pBin->left->obj,offsef); 



PNOD NodGetLeft( PNOD pNod ) 

1 return (PNOD) BinClientGetLeft( &pNod->bin, NodOffset ); 



Example 1 1 - Simple Communication From BinaryTree to Node. 



What's going on here? Simply that BinaryTree is storing BinaryTree pointers 
(left and right). But because each BinaryTree is a superclass of Node (we 
assume a homogeneous BinaryTree), we can compute the Node pointer from a 
BinaryTree pointer by adding an offset to the BinaryTree pointer . The function 
ObjGetClient does just that. It adds the (negative) offset to the object pointer to 
yield a new object pointer. Note that we must cast the Object pointer returned 
by BinClientGetLeft to a Node pointer. This is why the Object superclass must 
always be the first member of a structure. 
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Table 1 shows the memory layout for the objects of class Node and BinaryTre 
Each structure member is of a fixed size and a fixed offset. Therefore, if we 
know the address of a structure member, we can compute the address of the 
structure which includes it. (Sizes shown are for the small memory model ) 



Class 


Size 


Mem 


Size 


Offset 


Description 


Nod 


10 


obj 


2 


0 








name 


2 


2 








bin 


6 


4 


The value of NodOffset 


Bin 


6 


obj 


2 


0 








left 


2 


2 








right 


2 


4 





Table 1 - Memory Layout for Node and BinaryTree Objects 



The offset value NodOffset gets computed automatically in the early stages of 
the program (something we will describe later). On first glance, having to pass 
in offsets may seem a bit of a nuisance. Keep in mind though that BtaaryTree 
is being written independently of Node. We would like to build other classes on 
top of BinaryTree, and they will have different offsets. 

C+O has facilities for allowing us to ignore offsets (with no additional cost in 
complexity or storage), but we typically would not do this. The reason is 
because offsets have a performance advantage when multiple levels of 
inheritance occurs, which typically is quite often. For example, we might want 
to allow Node to be inherited by another class. This means we need to add a 
(negative) offset to Node pointers to get client structure pointers. Example 12 
shows how this works in practice. 



POBJ NodClientGetLeft( PNOD pNod, Mediumlnt offset ) 
return BinClientGetLeft( &pNod->bin, NodOffset + offset ); 



Example 12 - Inheritable Node routine 



In Example 12, to get the client structure pointer of the left subnode of pNod 
we get the left subtree of the BinaryTree pNod.bin, add NodOffset to get the left 
subnode of pNod, then add offset to get the client structure of that subnode. 
When these type of functions get converted into macros, the resulting code is 
very efficient. & 
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Visiting Objects 

We now understand how a class can communicate with its client, albeit in an 
indirect way. Now let's see how a class can call a client function. Example 13 
shows how this can be done. 



Void BinClientVisitPreOrder(PBIN pBin, Medium I nt offset.PBLK pBlk) 

PBIN left; 
PBIN right; 

if ( IpBin ) 
return; 
left = pBin->left; 
right = pBin->right; 

BlkExecute( pBlk, ObjGetClient( pBin, offset ) ); 
BinClientVisitPreOrder( left, offset, pBlk ); 
BinClientVisitPreOrderj right, offset, pBlk ); 



Void NodVisitPreOrder( PNOD pNod, PBLK pBlk ) 

1 BinClientVisitPreOrder( &pNod->bin, NodOffset, pBlk ); 



Void NodPrintPreOrder( PNOD pNod ) 

* Block blk; 

Blklnit( &blk, NodPrint ); 
NodVisitPreOrder( pNod, &blk ); 
BlkDelnit(&blk); 



Void NodPrint( PNOD pNod ) 

printf( "Node is %s\n", pNod->name ); 



Example 13 - Node Visit Function 
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Before we talk about what the BinCllentVisitPreOrder and NodVisitPreOrder 
function are doing, we need to introduce a new class called Block. A Block 
object can store a function pointer and several arguments. At some later time, 
a call to BlkExecute will cause the stored procedure to be executed and any 
parameters stored in the Block will be passed along to it. The first parameter 
sent to the function is a pointer which is passed in at the time BlkExecute is 
called. BlkExecute behaves much like an indirect function call. 

Ok, now back to BinClientVisitPreOrder and NodVisitPreOrder. These are what 
we call traversal functions. A traverse function is said to walk the nodes of a 
data structure in some predefined order. As we walk the data structure, we 
visit each node along the way. (We use the term node generically and Node to 
refer to the Node class). 

In Example 13 what happens is the following. BinClientVisitPreOrder walks 
the binary tree in pre-order. (Pre-order is just one of many ways to visit all the 
nodes of a binary tree.) To visit a node, it calls the function BlkExecute 
passing it the client of the BinaryTree node being visited. BlkExecute will call 
the client function (established by Node) passing the object pointer it receives 
as a parameter. In this way, BinClientVisitPreOrder is calling (visiting) a Node 
function and passing it a Node pointer for each BinaryTree. 
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Sending Messages 

In our next example, we show how a client can inherit behavior through 
messages from a server class as well as override default behavior for a server 
class. 

In Example 14a and 14b we show two different methods for deallocating nodes 
of a BinaryTree. Only one of them is correct. In both cases, the function 
ObjDestroy function is called to deallocate the object. ObjDestroy is always 
used to deallocate objects created by ClsNewObject. 

In the incorrect one, Example 14a, BinDestroy tries to free BinaryTree objects. 
However, the BinaryTree object is part of a larger object that was allocated, 
namely a Node. Therefore, the call to ObjDestroy will not succeed (it can tell if 
there is a subobject) . Worse, even if that could work, the Node has additional 
allocated memory which must be reclaimed prior to the Node being freed. 



Void BinDestroyAII( PBIN pBin ) 

* Block blk; 

Blklnit( &blk, BinDestroy ); 
BinClientVisitPreOrder( pBin, 0, &blk ); 
BlkOeinit( &blk ); 



Void BinDestroy( PBIN pBin ) 

ObjDestroy( &pBin->obj ); I* This is an error */ 



Example 14a - Wrong Way to Free Nodes 
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Example 14b shows how a Node function could deallocate itself and all its 
subnodes. But is there any way we could write BinDestroyAll so that it works 
properly? 



Void NodDestroyAII( PNOD pNod ) 
Block blk; 

Blklnit( &blk, NodDestroy ); 
NodVisitPreOrder( pNod, &blk ); 
BlkDelnit( &blk ); 



Void NodDestroy( PNOD pNod ) 

free( pNod->name ); 
ObjDestroy( &pNod->obj ); 



Example 14b - How to Destroy All the Nodes in a BinaryTree 



The answer is yes. The solution is to have the BinaryTree object send a 
message requesting that the object be freed. Sending a message is like railing 
a function except you're not sure the exact function which will be called. This 
may sound confusing. However, it is up to the function which gets invoked to 
make sure the action you requested takes place. This process of choosing the 
function at run-time rather than at compile time is called dynamic binding. 
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By default, If Binaiytree has no subclass, the destroy message 
(MSGJBINJDESTROY) will call BinDestroy. But Node overrides this message 
with its own function NodDestroy which does the appropriate cleanup and 
frees the node. (We are just about ready to show you how all this is done, so 
hang on.) Example 15 shows the code which implements this properly. 



Void BinDestroyAII( PBIN pBin ) 

* Block blk; 

Blklnit( &blk, BinSendDestroy ); 
BinClientVisitPreOrder( pBin, 0, &blk ); 
BlkDelnit(&blk); 



#define MSG_B IN_DESTROY 0 
Void BinSendDestroy( PBIN pBin ) 
* Block blk; 

Blklnit( &blk, NULL ); 

ObjSendMessage( &pBin->obj, MSG BIN DESTROY, pBlk 
BlkDelnit(&blk); 



Example 15 - Sending a Message 



This demonstrates how an object's default behavior can be changed by a client 
class without changing the code for the server class. This extends the ability to 
make reusable classes even more general and feature rich than they otherwise 
could be. 
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MetaClass 



At this point we need to explain how Object and Class classes understand so 
much about structures and offsets and how they can send messages to one 
another. C+O provides a number of classes which allow this behavior to be 
defined. The first class to examine is MetaClass. 

The MetaClass class is used to define the structure of a class, characteristics of 
objects of that structure type, superclasses of that class, and messages which 
it inherits and may be inherited by other classes. Example 16a shows the 
MetaClass definition for BinaryTree. You may wish to refer to the reference 
sections on MetaClass, MetaMessage, and MetaSuperClass for a complete 
description of the structure members of these classes. 



I* MetaMessages for class BinaryTree */ 
Mms BinMmsfl - { 
{ MMS_CHECK_WORD, 

NULL, 

"destroy", 

BinDestroy 

}> 



r Default value 7 
r Superclass msg to override */ 
I* Name of message 7 
/* Default method for message 7 



r MetaClass instance for class BinaryTree 7 
Mcl BinMcl = { 

MCL_CHECK_WORD, 
"BinaryTree", 



sizeof(Cls), 
sizeof(Bin), 
BinMms, 
1. 

NULL, 
0, 

MclCreateCIs, 
CIsDestroy 

}; 



I* Default value 7 

I* Name of class being described 7 
r Default value 7 
I* Size of class instance 7 
r Array of MetaMessages 7 
r Number of messages 7 
/* NULL if no superclasses 7 
I* Number of superclasses 7 
I* Default class creation tunc 7 
I* Default class destruct func 7 



Example 16a - MetaClass Definition for BinaryTree 

A MetaClass consists of three components: MetaSuperClass definitions, a 
MetaMessage definitions, and a MetaClass definition (which references the 
MetaMessage and MetaSuperClass definitions). 

In Example 16a, BinaryTree has no superclasses (other than Object which is 
always assumed), therefore no MetaSuperClass definition appears. 
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The MetaMessage definition (BinMms) defines one message called destroy for 
the BinaryTree class. The default method which will be executed when this 
message is sent is BinDestroy. However, a subclass may (and should in this 
example) override that message as we will see shortly. The index of the 
MetaMessage in BinMms is how you identify a message when a BinaryTree 
object wishes to send a message. That is why MSG_BIN_DESTROY had the 
value 0 in Example 15b. 

The MetaClass definition (BinMcl) defines the size of an instance of type 
BinaryTree. The other values given are defaults (see MetaClass reference 
section for more details). 

Instances of MetaClass, MetaMessage, and MetaSuperClass (not shown above) 
are always defined statically. There should be one instance of a MetaClass 
(and associated MetaMessages, and MetaSuperClasses) for each class you 
define. Primitive classes need not have a MetaClass as they never 
communicate with their subclasses. 
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Example 16b shows the MetaClass definition for the class Node. In it we see 
that it has one superclass, BinaryTree and overrides one message, "destroy". 



Node NodDummy = {0}; I* Example Node instance 7 

Mediumlnt NodOffset = 0; I* Offset of Bin superclass 7 

I* MetaSuperClasses for class Node V 

Msc NodMscfJ = 

{ 

{ MSC_CHECK_WORD, /* Default value 7 

"Bin", r Name of superclass instance 7 

(POBJ) &NodDummy, /* Example instance of Node 7 

(POBJ) &NodDummy.bin, I* Example instance of superclass 7 

&NodOffset r Store superclass offset here 7 

>> 

I* MetaMessages for class Node 7 
Mms NodMmsQ = { 

{ MMS_CHECK_WORD, /* Default value 7 

"Bin", r Override Bin destroy 7 

"destroy", r Name of message 7 

NodDestroy r Method to override message 7 

}> 

I* MetaClass instance for class Node 7 
Mcl NodMcl = { 

MCL CHECK WORD, 



}; 



"Node", 

sizeof(Cls), 

sizeof(Nod), 

NodMms, 

1, 

NodMsc, 
1, 

MclCreateCIs, 
CIsDestroy 



r Default value 7 
r Name of class being described 
r Default value 7 
/* Size of class instance 7 
r Array of MetaMessages 7 
I* Number of messages 7 
/* Array of MetaSuperClasses 7 
/* Number of superclasses 7 
/* Default class creation func 7 
r Default class destruct func 7 



Example 16b - MetaClass Definition for Node 
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The variable NodDummy is used in the initialization of the MetaSuperClass 
instance. It is used to calculate the offset of the BinaryTree superclass from 
the beginning of the Node structure. This offset is computed when 
MclCreateClass is called (for NodMcl) and the resulting value is stored in 
NodOffset. 

By overriding the message "destroy", an ObjSendMessage call by an instance of 
BmaryTree will result in a call to NodDestroy, passing it not a Bin pointer, but 
a Nod pointer. If Node were to be subclassed by another structure and Node's 
destroy message was overridden, then that function would be called with a 
pointer to that class instance. This can go on for as many levels as need be. 

During program initialization, we must call MclCreateClass, passing it an 
instance of a MetaClass. It creates and returns a pointer to an object of tvoe 
Class. Example 17 shows how this occurs. 



Class 'NodCIs = {0}; 

NodCIs = MclSendCreateClass( &NodMcl ); 



Example 17 - Creating a Class Instance for Node 

Objects of type class are used to create instances of a specific structure. In 
this case, NodCIs can be used to create objects of type Node as we saw in 
Example 8. 

Remember, we only need to define MetaClass definitions and Class instances 
for class types which we wish to communicate with subclasses or when we are 
inheriting classes which have MetaClass definitions. Primitive classes, like our 
Point and Rectangle examples, do not need such definitions. C+O classes 
which do not need MetaClass definitions are labeled as a Primitive Class in 
their class reference section. 
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Frameworks 



Next we show how a class can define a framework for subclasses to follow. A 
framework is also known as an abstract superclass. 

Example 18 shows a class named DisplayShape. DisplayShape implements 
the basic behavior common to all types of display shapes. It is like any other 
class with the following exception. It defines messages which are not 
implemented by the class and therefore must be provided by a client. This is 
signified by making the method structure member of a MetaMessage be NULL. 



#define PDSH struct DisplayShape * 
struct DisplayShape { 

Object obj; 

Point mbr; 

}; 

typedef struct DisplayShape DisplayShape; 
typedef struct DisplayShape Dsh; 



Mms DshMmsQ = { /* Messages for class DisplayShape 7 
' MMS_CHECK_WORD, NULL, "destroy", NULL}, 
MMS_CHECK_WORD, NULL, "display", NULL }, 
MMS_CHECK_WORD, NULL, "erase", NULL }, 
MMS_CHECK_WORD, NULL, "rotate90", NULL } 

}; 

Mcl DshMcl = { 

MCL_CHECK_WORD, 

"DisplayShape", 

sizeof(Class), 

sizeof(DisplayShape), 

DshMms, 

sizeof(DshMms)/sizeof(Mms), 

NULL, 

0, 

MclCreateClass, 
CIsDestroy 

}> 



Example 18 - DisplayShape Framework Class 

In general, and DisplayShape in particular, you cannot create instances of a 
framework. Instead, you create instances or clients (subclasses) of frameworks. 
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In Example 19, we define a client class of DisplayShape called RectangleShape. 
RectangleShape inherits from DisplayShape and provides the display shape - 
specific functions display, erase, and rotate90. These functions must be 
rewritten by each class which inherits from DisplayShape. 



#define PRSH struct RectangleShape * 
struct RectangleShape { 

Object obj; 

Rectangle ret; 

DisplayShape dsh; 

}; 

typedef struct RectangleShape RectangleShape; 
typedef struct RectangleShape Rsh; 

Rsh RshDummy = {0}; 

Mediumlnt RshOffset » 0; r Holds Dsh offset 7 

Msc RshMscf] = { 

{ MSCCHECK WORD, 

"Dsh", 

&DshMcl, 

(POBJ) &RshDummy, 
(POBJ) &RshDummy.dsh, 
SRshOffset} 

}; 

Mms RshMmsfl = { 

' MMS_CHECK_WORD, "Dsh", "destroy", RshDestroy }, 
MMS_CHECK_WORD, "Dsh", "display", RshDisplay } 
MMS_CHECK_WORD, "Dsh", "erase", RshErase }, 
. MMS_CHECK_WORD, "Dsh", "rotate90",RshRotate90" } 

}; 

Mcl RshMcl = { 

MCL_CHECK_WORD, 
"RectangleShape", 
sizeof (Class), 
sizeof(RectangleShape), 
RshMms, 

sizeof(RshMms)/sizeof(Mms), 
Rsh Msc, 

sizeof(RshMsc)/sizeof(Msc), 
MclCreateClass, 
CIsDestroy 



Example 19 - Client Class RectangleShape 
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By creating a separate class for each display shape, we have factored display 
shapes into two type of code. That which is applicable to all display shapes 
regardless of type, and that which is specific to a particular display shape. 
This kind of factoring makes programs much more modular and 
understandable. It also makes adding new lands of display shapes very easy. 

In Example 20 we see how DisplayShape actually relies on the messages erase 
and display to implement the move function. Implementing the move function 
in this manner allows us to not have to rewrite it for each display shapel 



Void DshMove( PDSH pDsh, PPNT pPnt ) 
* Block blk; 

Blklnit( &blk, NULL ); 

ObjSendMessage( &pDsh->obj, MSG_DSH_ERASE, &blk ); 
PntAddPnt( &pDsh->origin, pPnt ); 

ObjSendMessage( &pDsh->obj, MSG DSH DISPLAY, &blk ); 
BlkDelnit( &blk ); 



Example 20 - DisplayShape Creates a Framework for Moving Shapes 



We have now seen how a class can be written which relies on client classes to 
perform some of the work. Such classes are called frameworks, or abstract 
superclasses. The benefit to this is that we can write programs which 
manipulate abstract objects of which there may be an unknown number of 
specific types. As new types are needed, they can easily be added into the 
system with almost no changes to the existing code. 

Next, we show how to override messages which have the same name in 2 or 
more superclasses. 
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Overriding Messages and Multiple Inheritance 

Multiple inheritance (conceptually) creates a slight problem when we have two 
or more superclasses which define the same message. The problem is that we 
need precision control when overriding messages so that we know exactly 
which superclass we are referring to when overriding a message. We also want 
to make sure that a message overridden by a subclass will trickle-down 
appropriately to the superclasses. Many OOPLs have a problem with multiple 
inheritance for this reason. C+O provides a great deal of control so that no 
ambiguity arises when overriding messages. 

In Example 21, we see how the C+O class Edge overrides the destroy message 
from the three IistElements it inherits from (refer for a moment to the 
reference section on Edge, specifically the section on Class Implementation). 



Msc EdgMscn = { 

{ MSC_CHECK_WORD, 

"GrfLel", 

&LelMd, 

(POBJ) &EdgDummy, 
(POBJ) &EdgDummy.grfLel, 
&EdgGrfLelOffset 

{' MSC_CHECK_WORD, 
"VtxInLel", 
SLelMcl, 

(POBJ) &EdgDummy, 
(POBJ) &EdgDummy.vtxlnLel, 
&EdgVtxlnLelOffset 

{' MSC CHECKJ/VORD, 
"VtxOutLel", 
&LelMcl, 

(POBJ) EdgDummy, 

(POBJ) &EdgDummy.vtxOutLel, 

&EdgVtxOutLelOffset 



Mms EdgMmsfJ = { 

{ MMS_CHECK_WORD, "GrfLel", "destroy", EdgDestroy }, 
MMS_CHECK_WORD, "VtxInLel", "destroy", EdgDestroy }, 
MMS_CHECK_WORD, "VtxOutLel", "destroy", EdgDestroy } 

}; 



Example 21 - Edge Class Overrides the Same Message 
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Edge defines three superclasses, all of them UstElements. Each one Is named 
differently: GrfLel, VtxInLel, and VtxOutLel. This allows us to select between 
superclasses by name without ambiguity. 

Edge also defines three MetaMessages. Each MetaMessage can override a 
message from one and only one superclass. Therefore, the destroy message 
inherited by each UstElement must be overridden by a separate MetaMessage. 
Any one of the UstElement superclasses may send the destroy message to 
Edge so each one must be overridden explicitly. 

Note that while we chose to override all three messages with the identical Edge 
function (EdgDestroy), we could have used a different Edge function for each 
one. This is very flexible and in practice quite useful. 

But what happens when a client class of Edge overrides the destroy message? 
First of all, let's make clear that the client class of Edge cannot specify the 
particular destroy message to override. We don't even want the client class to 
care that there is more than one destroy message — that is simply a function of 
the implementation of Edge. 

The first destroy message which is found in the MetaMessage table can always 
be overridden by the client class. In our example then, a client of Edge could 
override the destroy function associated with GrfLel. So if the GrfLel 
ListElement were to send a destroy message, it will be properly routed to the 
client of Edge. But how about VtxInLel and VtxOutLel. 

C+O uses the following algorithm to determine how to override the other 
destroy messages. If subsequent destroy messages listed for Edge have 
identical semantics (i.e. they call the same function as the first), then they will 
be overridden by a client class as well. Because in our example they do, 
destroy messages sent by VtxInLel and VtxOutLel will be overridden too. Note 
that because Edge has three identical messages it can choose one of three 
values for the destroy message and still call the same function. 

The search for identical messages stops on the first non-match. Therefore, you 
should always group messages with the same name together. 
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What's In a Name? 

One of the things that can help a programmer better understand his own code, 
or that of others, is if functions get named according to some conventions. 

In C+O we have developed a naming system which strives to be consistent not 
only within a class, but across classes. The following are some names which 
get used consistently throughout C+O. 

Init. Init functions are always used to initialize newly allocated memory. Each 
class should have an init function and should require that it be the first 
function to call prior to using any other functions for an object. The init 
function should initialize an object sufficiently so that it can be used by other 
functions. Init functions never return a value. 

Delnit. This is the inverse of the Init function. Delnit is always capitalized as 
shown. It should be the last function called on an object just prior to 
deallocating its memory. Every class should provide a Delnit function and 
should require its usage prior to deallocation. Delnit should deallocate any 
memory 

allocated to the object (other than the memory for the object). It should also 
ensure (to whatever degree possible) that it is not referenced by any other 
objects. Using an object which has been deinitialized is equivalent to using an 
object that has not been initialized and should result in an exception being 
triggered. Delnit functions never return a value. 

Create. Create functions are used to create instance of other objects. For 
example, MclCreateGls creates objects of type Class. The return value from a 
Create function should always be a pointer to the newly created object. Create 
functions should always call the appropriate Init function before returning the 
object pointer. Most classes should create objects by calling ClsCreateObject. 

Destroy. Destroy functions deinitialize and deallocate the memory for an 
object. The object should not be accessed after being destroyed. Destroy 
functions should first Clear the object or otherwise prepare it for 
deinitialization. It should then be deinitialized and finally the memory should 
be deallocated by calling ObjDestroy (assuming the object was allocated by 
ClsCreateObject). The Destroy function for a class always destroys an object of 
that type. Destroy functions never return a value. 

Clear. Clear functions are provided by most every class and are used to set an 
object back to its state just after initialization. 

Get. Get functions are used to retrieve values from an object. Typically the 
values are stored in the object but they may be calculated in some way as well. 
Get functions should always return something. 
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Is, Has, Can, etc. These functions are generally used to query an object about 
its state. For example, DlUsEmpty answers the question, "Is the list object 
empty?". The function name is always worded as a question to be answered. 
The return value is always a Bool. 

Visit. Visit functions traverse an object which has some structure to it. Visit 
functions always take a Block object as a parameter, executing the Block for 
each object to be visited. 

Client. Client functions are provided by classes which use advanced 
inheritance techniques to achieve reusability. Client Get functions always 
return objects which are a subclass of the object. Client Visit functions always 
visit the subclass objects of an object and so on. 

Range. Range functions have no special function except to imply that two of 
the arguments to a function represent a beginning and ending element and all 
the elements in between. 



Conclusion 

This concludes our introduction to using C+O object-oriented programming 
facilities. For further examples, specifically on the use of individual classes in 
C+O, you may wish to look at the sample code provided with this package. C 
source code prefixed with TST demonstrates the use of many of the C+O 
classes. 
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Structure Name: 



Block 



Abbreviation: 



Blk 



Class Type: 



Primitive Class 



Introduction 

The Block class is used to hold a function pointer and parameters to pass to 
that function. A block can be passed to other functions which have no 
knowledge of the contents of the block. The block can subsequently be asked 
to execute the function, passing the parameters stored with it. 

Blocks are used as part of the messaging sending mechanism. They are also 
used by Visit functions (see Tree for extensive examples). You may wish to use 
them when creating your own Visit functions for a Class. 

The term Block is a carryover from Smalltalk. Smalltalk uses them to 
implement user-definable control structures. In effect, that's exactly what 
Blocks allow you to do. 

MetaClass, along with Class, Object, Message, MetaSuperClass, MetaMessage, 
and Block collectively define and implement the object-oriented properties of 
inheritance and dynamic binding (messaging) in C+O class libraries. 
Encapsulation, while supported by the above code, can be implemented by the 
programmer simply writing enough functions for a structure to obviate the 
need to access the structure members directly. These classes should be studied 
as a group to understand how C+O implements object-oriented C programs. 
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Block 



Description 

A Block can hold up to 16/32 bytes (depending on memory mode) of 
parameters to pass to a function. The object pointer which gets passed to 
Block on an execute call does not take up parameter space in the block. 

A Block may not call functions where the funtion called pops the arguments off 
the stack. This should not be a problem unless the function being called is 
declared with the Pascal keyword. Later releases of C+O may remove this 
restriction. 



Glossary and Special Terms 

There is no special glossary for Block. Instead, refer to the tutorial section on 
object-oriented techniques in C+O. 

Class Implementation Block 



Instance Variables 

The following is the data structure definition for a Block. 

struct Block { Medium Int blkCheck; 

PMTH method; 

USmalllnt index; 

UMediumlnt parmsQ; } 

blkCheck Uniquely identifies Block instances 

method Function to call 

index Keeps track of how many parameters have been pushed 

parms An array for storing parameters 

Superclasses 

The Block class is primitive and has no superclasses. 

Messages and Responses 

The Block class is primitive and has no messages. 

Class Variables 

The Block class has no class variables. 
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Block 



Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 



BlkClear 


Clear instance 


Blk 


•2 


Public 


N 


BlkDelnit 


Deinitialize instance 


Blk 


■3 


Public 


N 


BlkExecute 


Execute method with parameters 


Blk- 


•4 


Public 


N 


BlkExecuteRetBool 


Execute the method, return int 


Blk- 


•5 


Public 


N 


BikExecuteRetDataPtr 


Execute method, return mem pointer 


Blk- 


•6 


Public 


N 


BlkExecuteRetFuncPtr 


Execute method, return function ptr 


Blk - 


■7 


Public 


N 


BlkExecuteRetlnt 


Execute method, return int 


Blk- 


8 


Public 


N 


BlkHasMethod 


Return True if instance has non-NULL method 


Blk 


•9 


Public 


N 


Blklnit 


Initialize instance 


Blk- 


•10 


Public 


N 


BlkPrint 


Print contents of instance 


Blk- 


11 


Public 


N 


BlkPushDataPtr 


Save pointer parameter 


Blk- 


12 


Public 


N 


BlkPushFuncPtr 


Save function pointer parameter. 


Blk- 


13 


Public 


N 


BlkPushlargelnt 


Save Largelnt parameter 


Blk- 


14 


Public 


N 


BlkPushMediumlnt 


Save Medium Int parameter 


Blk- 


15 


Public 


N 


BlkSetMethod 


Set the function to call 


Blk- 


16 


Public 


N 



Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


BlkClear 


Clear instance 


Blk -2 


N 


BlkDelnit 


Deinitialize instance 


Blk -3 


N 


BlkExecute 


Execute method with parameters 


Blk -4 


N 


BlkExecuteRetBool 


Execute the method, return int 


Blk -5 


N 


BikExecuteRetDataPtr 


Execute method, return mem pointer 


Blk- 6 


N 


BlkExecuteRetFuncPtr 


Execute method, return function ptr 


Blk -7 


N 


BlkExecuteRetlnt 


Execute method, return int 


Blk -8 


N 


BlkHasMethod 


Return True if instance has non-NULL method 


Blk -9 


N 


Blklnit 


Initialize instance 


Blk -10 


N 


BlkPrint 


Print contents of instance 


Blk- 11 


N 


BlkPushDataPtr 


Save pointer parameter 


Blk-12 


N 


BlkPushFuncPtr 


Save function pointer parameter. 


Blk- 13 


N 


BlkPushLargelnt 


Save Largelnt parameter 


Blk- 14 


N 


BlkPushMediumlnt 


Save Mediumlnt parameter 


Blk-15 


N 


BlkSetMethod 


Set the function to call 


Blk- 16 


N 
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Block 



Private Functions 



None 








Undocumented Functions 


None 









Friend Functions 



None 



Listing Of Functions by Category 

Initialization Functions 



Function Name Description Page Scope Macro 



BlkClear 


Clear instance 


Blk-2 


Public 


N 


BlkDelnit 


Deinitialize instance 


Blk-3 


Public 


N 


Blklnit 


Initialize instance 


Blk-10 


Public 


N 




Execute Functions 








Function Name 


Description 


Page 


Scope Macro 


BlkExecute 


Execute method with parameters 


Blk-4 


Public 


N 


BlkExecuteRetBool 


Execute the method, return int 


Blk-5 


Public 


N 


BikExecuteRetDataPtr 


Execute method, return mem pointer 


Blk-6 


Public 


N 


BlkExecuteRetFuncPtr 


Execute method, return function ptr 


Blk-7 


Public 


N 


BlkExecuteRetlnt 


Execute method, return int 


Blk-8 


Public 


N 




Query Functions 








Function Name 


Description 


Page 


Scope Macro 


BlkHasMethod 


Return True if instance has non-NULL method 


Blk-9 


Public 


N 
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D bug Functions 



Function Name 


Description 


Page 


Scope Macro 


BlkPrint 


Print contents of instance 


Blk -11 


Public 


N 



Push Functions 



Function Name Description Page Scope Macro 



BlkPushDataPtr 


Save pointer parameter 


Blk- 12 


Public 




N 


BlkPushFuncPtr 


Save function pointer parameter. 


Blk- 13 


Public 




N 


BlkPushLargelnt 


Save Largelnt parameter 


Blk- 14 


Public 




N 


BlkPushMediumlnt 


Save Mediumint parameter 


Blk- 15 


Public 




N 


BlkSetMethod 


Set the function to call 


Blk- 16 


Public 




N 



Listing Of Functions With Macros Available 



None 
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Class Description for Class 



Structure Name: 



Class 



Abbreviation: 



CIs 



Class Type: 



Primitive Class 



Introduction 

The class Class is used to create instances of objects. This is probably all you 
will ever use Class for unless you are writing functions for the class Object 

Instances of Class are created by calling MclCreateClass and passing in an 
MetaClass instance which describes the Class. 

MetaClass, along with Class, Object Message, MetaSuperClass, MetaMessage, 
and Block collectively define and implement the object-oriented properties of 
inheritance and dynamic binding (messaging) in C+O class libraries. 
Encapsulation, while supported by the above code, can be implemented by the 
programmer simply writing enough functions for a structure to obviate the 
need to access the structure members directly. These classes should be studied 
as a group to understand how C+O implements object-oriented C programs. 



Summary of CIs - 1 



Class 



Description 

A function of Class is to describe or model the organization of a particular C 
structure. Since C structures can be organized hierarchically, we must define 
the structure Class, which models this hierarchy, in a hierarchical, recursive 
fashion similar to how one might describe a tree structure. To borrow from Tree 
terminology, a class may have a parent class and children classes. Figure 1 
shows an example of this hierarchy. 



Struct X ) Object 

Uediumlnt 
Struct A 
Struct B 

Struct A | Object 
Struct Q 




Figure 1 



The Class structure does not try and model the complete description of a 
structure. It is only interested in modelling superclasses which are described 
with MetaClasses. Therefore, structure components such as ints, or even 
structures like JulianTime would not be described by a Class. 

A MetaClass has one instantiation for each structure being defined. A Class on 
the other hand, has one instance per use of the structure. Therefore if a 
structure X is included in three other structures, there would be three 
instantiations of the Class X. 

Glossary and Special Terms 

The Class hierarchy has its own special terminlogy for a parent Class and 
children Classes. If X is an instance of Class, then the parent of X is called Xs 
subclass and the children of X are called Xs superclasses. X is said to inherit 
from its superclasses. If X has no subclass, it is the root subclass. If X has no 
superclasses, it is a simple class. 

For other definitions, see the tutorial section on object-oriented techniques. 
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Class Implementation Class 



Instance Variables 

The following Is the data structure definition for a Class. 



struct Class { 



Medium I nt 

PMCL 

PCLS 

Mediumlnt 

PCLS 

Mediumlnt 

Mediumlnt 

PCLS 

PMSG 



clsCheck; 

mcl; 

subCIs; 

subOffset; 

mostSubCIs; 

mostSubOffset; 

sublndex; 

*superClsArray; 

msgArray; } 



clsCheck 

mcl 

subCIs 

subOffset 

mostSubCIs 

mostSubOffset 

sublndex 

superClsArray 

msgArray 

Superclasses 



Uniquely identifies Class instances. 

The MetaClass which describes this class. 

The subclass of this class (or NULL). 

The offset from the subclass. 

The root subclass. 

The offset from the root subclass. 

The superclass index. 

The array of superclass pointers. 

The array of messages for this class. 



The class Class is primitive and has no superclasses. 

Messages and Responses 

The class Class is primitive and has no messages. 

Class Variables 



The class Class has no class variables. 
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Class 



Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 



CIsCreateMessages 


Create the Msg instances 


N/A 




Undoc 


N 


ClsCreateObject 


Create a new Object instance 


CIs- 


2 


Public 


N 


CIsCreateSupers 


Create the superclass instances 


All A 

N/A 




Undoc 


Al 

N 


CIsDelmt 


Deinitialize the instance 


CIs - 


3 


Public 


N 


CIsDestroy 


W^. tt A A 1 * ■ 

Deallocate the instance 


CIs- 


4 


Public 


N 


CIsDestroyMessages - 


Destroy the messages 


N/A 




Undoc 


N 


CIsDestroyObject 


Deallocate the object instance 


CIS- 


5 


Public 


N 


CIsDestroySuperClasses 


Destroy the superclasses 


N/A 




Undoc 


N 


CIsRndMsg 


Rnd message given selector name 


CIS- 


7 


Public 


N 


CIsRndSelectorlndex 


Rnd index of selector given name 


CIS- 


8 


Public 


N 


CIsRndSuperClass 


Find superclass given name 


CIS- 


10 


Public 


N 


CIsGetMessageCount 


Get number of messages 


CIs- 


11 


Public 


N 


CIsGetMethodAndOffset 


Return method and sub/super offset 


CIS- 


12 


Public 


N 


CIsGetName 


Return name of the instance 


CIS- 


14 


Public 


N 


ClsGetNthMsg 


Get pointer to nth Message 


CIS- 


15 


Public 


N 


CIsGetNthSuperOass 


Get pointer to Nth superclass 


CIs- 


16 


Public 


N 


CIsGetObjectSize 


Return size of an object instance 


CIs- 


17 


Public 


N 


CIsGetOffsetForMsg 


Return sub/super offset of object 


Os- 


18 


Public 


N 


CIsGetOffsetOfNthSuper 


Return offset of nth superobject 


CIs- 


20 


Public 


N 


CIsGetRootSubClass 


Get the root subclass 


CIs- 


22 


Public 


N 


CIsGetRootSubObjectOffset 


A. tt At A 1 L • A 

Return offset of root subobject 


CIs- 


23 


Public 


N 


CIsGetRootSubObjectSize 


Return size of the root subobject 


CIs- 


24 


Public 


N 


CIsGetSize 


Return size of the instance 


CIs- 


25 


Public 


N 


CIsGetSubClass 


Return subclass 


CIs- 


26 


Public 


N 


ClsGetSubObjectOffset 


Return offset of a subobject 


CIs- 


27 


Public 


N 


CIsGetSuperaassCount 


Return number of superclasses 


CIs- 


28 


Public 


N 


CIsGetSuperClasslndex 


Return superclass index 


CIs 


29 


Public 


N 


Clslnit 


Initialize the instance 


as- 


30 


Public 


N 


CIslsRoot 


Is instance the root subclass? 


CIs- 


31 


Public 


N 


ClsOffsetSupers 


Offset superclasses from subclass. 


N/A 




Undoc 


N 


ClsPrint 


Print the instance 


CIs- 


32 


Public 


N 


CIsSendOestroy 


Send destroy message to instance 


CIs- 


33 


Public 


N 


CIsSendObjectMessage 


Send object a message 


CIs- 


■34 


Public 


N 


CIsSendObjectMessageRetumlnt 


Send object message, returns Medium Int 


CIs- 


36 


Public 


N 


CIsSendObjectMessageRetumPtr 


Send object message, returns Void * 


CIs- 


•38 


Public 


N 


CIsSuperClassOf 


Initialize sub/super relation 


N/A 




Undoc 


N 
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Function Listing By Scope 

Public Functions 



Function Name 


Descrinttan 




Morro 


ClsCreateObiect 

vlwvl wUlwwUJwWl 


Prpatp Sk now Ohiprt in<itan<v» 


ViO £ 


M 


CIsDpinit 

wlwl^eil 111 


npinitidli7P tho inctanAo 
Uell llUdJlZe U Ic HlolaJJUc 


via * 0 


M 


VldUeoUUy 


ftoollAA4fA a inpHnM 

ueaiiocaie me instance 


KjiS - 4 


IM 


PIcOp ctmx/O hiorf 


HoollAAoto f Hq AhioAt inetonAo 

ucdiiocaie ine oujeci instance 


Pic G 
viS • D 


Kl 
IM 


PkRnriMcn 

VIOI II IUIVIOU 


Pi nH moccona nn/on coioAtAr noma 
riiiQ Hlebbayo given beieului ikiiilc 


pie - 7 

UlS / 


Kl 
IM 


P 1 c f-i n fi Qo \&rtnr\ n Wo v 


nna inaex or seiecior given name 


Pie Q 

vIS - o 


Kl 
N 


PIcPinHQi inorPIaec 
vldrinuOUpelvldbS 


rina superclass given name 


US - 10 


Kl 

IM 


PkftptMpcoanpPni mt 

VldwCUVICOvXiyc VvUI 11 


f^ot ni imhflr Af itioccoaoc 

del nuiiiueT ui incbodycb 


Pie - 1 1 
vIS - 1 1 


Kl 
IM 




Roti im mothAH onH ei iK/ei trior Aff cot 
nclUiil IlleillUU alio oUO/oUpci Oil bet 


PIc - 10 
vIS - \C 


Kl 
IM 


CkfiptNamp 


Ron irn no mo nf tho inctonAO 


Pie . 1A 
vl5 l*t 


Kl 
IM 


PkftptNthMcsi 


f^ot nAintor f a nth kAaccona 

Uei (joiiiicr lo nin M&ssayB 


Pic 1C 
vIS - 10 


Kl 
IM 


PkftptNlth^i inorPiacc 
v lode UN 11 1 OU |Je i vldob 


uci pointer io not superclass 


Pic 1 A 
vIS - 1 0 


Kl 
IM 


PkfiptOhiPTt^i^P 


Doh im ci?o Af on aKS oa$ inctonAA 

nciurn size oi an oojeci instance 


Pie 17 
vtS - 1 / 


Kl 
IM 


CkGptOffcptFnrMc/i 


Rpti im ci iK/cj inor Aff cot Af nhioAt 
nclUill bUU/bUpei 0 libel Of ODJcvl 


PJc - 1ft 
viS " 10 


Kl 
IM 


CIsGptOffcptOf NfhSi jnpr 


Roh tm Aff cot Af nth ci inornhioAt 
neiuin oiioct Oi run super uujcul 


Pic . on 
via * cu 


Kl 
IM 


CIsGptRontSnhPlflsc 

wltfvJCUiUUiwUUwladd 


r^ot tho rAAt ci iaaIocc 
Oct Ule lOOt bUDudbb 


Pic - 00 
vlo 


Kl 
IM 


CIsGetRootSubObjectOffset 


Return offset of root subobject 


CIS -23 


N 


CIsGetRootSubObjectSize 


Return size of the root subobject 


Qs -24 


N 


CIsGetSize 


Return size of the instance 


CIS -25 


N 


CisGetSubClass 


Return subclass 


as -26 


N 


CisGetSubObjectOffset 


Return offset of a subobject 


CIS -27 


N 


CIsGetSuperOassCount 


Return number of superclasses 


CIS -28 


N 


CIsGetSuperClasslndex 


Return superclass index 


OS -29 


N 


Clslnit 


Initialize the instance 


as -30 


N 


CIslsRoot 


Is instance the root subclass? 


CIS -31 


N 


ClsPrint 


Print the instance 


CIS -32 


N 


CIsSendDestroy 


Send destroy message to instance 


as-33 


N 


CtsSendObjectMessage 


Send object a message 


CIS -34 


N 


CIsSendObjectMessageRetumlnt 


Send object message, returns Medium Int 


CIS -36 


N 


CIsSendObjectMessageReturnPtr 


Send object message, returns Void * 


CIS -38 


N 



Private Functions 



None 
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Undocum nted Fundi ns 



Function Name 


Description 


Page 


Macro 


CIsCreateMessages 


Create the Msg instances 


N/A 


N 


ClsCreateSupers 


Create the superclass instances 


N/A 


N 


CIsDestroyMessages 


Destroy the messages 


N/A 


N 


CIsDestroySuperClasses 


Destroy the superclasses 


N/A 


N 


ClsOffsetSupers 


Offset superclasses from subclass. 


N/A 


N 


ClsSuperClassOf 


Initialize sub/super relation 


N/A 


N 




Friend Functions 





None 



Listing Of Functions by Category 

Undocumented Functions 



Function Name 


Description 


Page 


Scope Macro 


CIsCreateMessages 


Create the Msg instances 


N/A 


Undoc 


N 


ClsCreateSupers 


Create the superclass instances 


N/A 


Undoc 


N 


CIsDestroyMessages 


Destroy the messages 


N/A 


Undoc 


N 


CIsDestroySuperClasses 


Destroy the superclasses 


N/A 


Undoc 


N 


ClsOffsetSupers 


Offset superclasses from subclass. 


N/A 


Undoc 


N 


ClsSuperClassOf 


Initialize sub/super relation 


N/A 


Undoc 


N 




Object Functions 








Function Name 


Description 


Page 


Scope Macro 


ClsCreateObject 


Create a new Object instance 


CIS -2 


Public 


N 


CIsDestroyObject 


Deallocate the object instance 


Cls-5 


Public 


N 


CIsSendObjectMessage 


Send object a message 


CIS -34 


Public 


N 


CIsSendObjectMessageRetumlnt 


Send object message, returns Medium Int 


CIS -36 


Public 


N 


CIsSendObjectMessageRetumPtr 


Send object message, returns Void * 


CIS -38 


Public 


N 



Summary of CIs - 6 



Class 



Initializati n Functions 



FunrHnn Mam a 


Description 


Page 


Scope 


Macro 


ClsOelnit 

ClsDestroy 

Clslnit 

CIsSendDestroy 


Oeinitialize the instance 
Deallocate the instance 
Initialize the instance 
Send destroy message to instance 


CIs -3 
Cls-4 
Qs-30 
Cls-33 


Public 
Public 
Public 
Public 


N 
N 
N 
N 




Query Functions 








Function Name 


Description 


Page 


Scope Macro 


CIsRndMsg 

CIsRndSelectorlndex 

CIsRndSuperClass 

CIsGetMessageCount 

CIsGetMethodAndOffset 

CIsGetName 

CIsGetNthMsg 

CIsGetNthSuperaass 

CIsGetObjectSize 

UioUciWlloclrOrivlsg 

CtsGetOffsetOfNthSuper 
CIsGetRootSubClass 
uisoeinooiouDUOjectuttset 
CIsGetRootSubObjectSize 

CIsGetSubClass 

ClsGptSi ihOhiprtfiff cot 

CIsGetSuperClassCount 
GIsGetSuperClasslndex 
CIslsRoot 


Rnd message given selector name 
Rnd index of selector given name 
Rnd superclass given name 
Get number of messages 
Return method and sub/super offset 
Return name of the instance 
Get pointer to nth Message 
Get pointer to Nth superclass 
Return size of an object instance 
Return sub/super offset of object 
Return offset of nth superobject 
Get the root subclass 
Return offset of root subobject 
Return size of the root subobject 
Return size of the instance 
Return subclass 
Hetum onset of a subobject 
Return number of superclasses 
Return superclass index 
Is instance the root subclass? 


CIS -7 
CIS -8 
CIs -10 
CIs- 11 
CIs -12 
CIs -14 
CIs -15 
CIs -16 
Qs -17 
as -18 

as -20 

CIS -22 
CIS -23 
OS -24 
CIS - 25 

as -26 

CIs -27 
OS -28 

as-29 

CIS -31 


Public 
Public 
Public 
Public 
Public 
Public 
Public 
Public 
Public 
Public 
Public 
Public 
Public 
Public 
Public 
Public 
Public 
Public 
Public 
Public 


N 
N 
N 
N 
N 
N 
N 
N 
N 
N 
N 
N 
N 
N 
N 
N 
N 
N 
N 
N 




Debug Functions 








Function Name 


Description 


Page 


Scope Macro 


ClsPrint 


Print the instance 


CIs -32 j 


Public 


N 


Listing Of Functions With Macros Available 




None | 
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Class Description for List 



Structure Name: List 

Abbreviation: Dll 

Class Type: Inheritable class 



Introduction 

The List class has a friend class called ListElement. The documentation for the 
List class should therefore be read in conjunction with the ListElement class. 

When sequential mapping is used for ordered lists, achieved using an array 
data structure, operations such as insertion and deletion of arbitrary elements 
become expensive because of the amount of data movement. Linked 
representations of ordered lists are an alternative to sequential 
representations. 

Description 

Unlike a sequential representation where successive items of a list are located 
a fixed distance apart, in a linked representation these items may be placed 
anywhere in memory. Each element points to the next element in the list and 
the previous element in that list. These elements are stored as part of the class 
ListElement. 

Besides the linked items a special node exists called the head node. The head 
node stores the first and last elements in the list. C+O stores the head node as 
part of the class List ListElements also store a pointer to the List they belong to 
(if any). 

It is customary to draw linked lists as an ordered sequence of nodes with links 
being represented by arrows. Figure 1 shows a sample doubly linked list with 4 
nodes {ListElements] A, B, C and D. The head node (List) points to nodes A and 
D. 

Head node 



Figure 1 
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List 



The List class is the data structure representation of the head node. The 
ListElement class is the data structure representation of a single element in a 
doubly linked list. 

Glossary and Special Terms 

Figure 2 shows the first and last element in a doubly linked list. Because each 
list element stores a pointer to the List class ( head node ) the first and last 
elements are also accessible from each element. 

The size of a list is the number of elements in that list. 

To get from the first element to the last element you would access successor, 
or next elements. To get from the last element to the first element you would 
access predecessor or previous elements. 

The predecessor of the first element is NULL. The successor to the last element 
is NULL. All other elements will have non-NULL predecessors and successors. 
There exists only zero or one predecessor for a given element. 




Figure 2 



A range of list elements is defined as a beginning list element and an ending 
list element. 

Examples of a valid range of list elements: 

1) A through H, here the range is from first to last. 2) C through E, here the 
range spans elements C, D and E. 3) F through F, here the range spans one 
element, F. 
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Examples of an invalid range of list elements: 

1) E through A, here the range is backwards. 2) A through I, here the range 
spans outside the list. 

The size of a List is the number of elements it contains. Figure 3 shows a 
doubly linked list with size 8. 




Figure 3 
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Class Implementation List 

Instance Variables 

The following is the data structure definition for a doubly linked list. 



struct List{ Object obj; 

Mediumlnt dllCheck; 

PLEL first; 

PLEL last; } 



obj Gives List class object-oriented properties of inheritance and 

dynamic binding. 
dllCheck Uniquely identifies List instances, 

first First element in list, 

last Last element in list. 

Messages and Responses 

The implementation of the destroy message is handled by DllDestroy however 
subclasses should override this message. The destroy message is not used by 
any methods of Dll. 



Selector Method Description 

destroy DllDestroy Destroy the object 

Class Variables 

Ty pe Name Description 

Mcl DIIMcl Metaclass description for List. 
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Function Listing In Alphabetic Order 



Function Name 


UCovilLJUUII 


Dana 
rayc 


Scope Macro 


DllADDpnd 


Annpnsi olomont tn lief 
npUCitU clcillctll 10 Hoi 


nn o 

UH * c 


Public 


N 


DIIAnnpnril aet 


Malto Plomont laet 
mdJvc olcMlclu tool 


Ull - 4 


Public 


Y 


DIIAsObi 


Rphim liot ac nhiprt 
nciuiii noi ao uujuul 


mi . a 

Ull " 0 


Private 


Y 


DllClear 


Clpflr thp liet 


nil - 7 

Ull / 


Public 


N 


DHCut 


ftiit nnp plpmpnt from liet 

VAIL VI 10 CiClMclll II Will Uol 


Ull " 0 


Public 


N 


DUCutChildren 

UliVUlWl lllui vf 1 


v/Ul all clelilcillo liuin llol 


Uii * lU 


Public 


N 


DIICutRanae 

WNVUU tCU IUv 


Ci it p(pmpnt/^\ fmm liet 


nn - 1 1 

UH 1 1 


Public 


N 


DHDelnit 


npinitisli7P lief nhio/*t 
UCH lIllaHZc Uol OujCvl 


nn iq 

Ull * 10 


Public 


N 


uiiucouuy 


r^ol r>i tio I lief #\hi^u*f mrl frrtrt pn^M 

ueiruiiaiize iisi oojeci ana iree space 


mi ia 
Ull - 14 


Public 


N 


nilfiptTHpnt 

UIIVJClWllGl 11 


neiurn cueni or nsi 


mi ic 
uii - 15 


Public 


Y 




Doff im ft ret atamanf 


no ic 
UU - id 


Private 


Y 


DUfiptf act 


neiurn iasi eiemeni 


nn 17 
UII - 1 / 


Private 


Y 


UIIVZClliu 1 


Dnti irn KifK clamant 

neiurn imui eiemeni 


mi 10 
Ull - lo 


Private 


N 


DIIGptSi7P 

Uu V3C lWl£C 


/•At Cl"70 ftf lief 

Ucl olZc 01 llol 


nit ia 
Uii - i9 


Public 


N 


Dlllnit 


lnitioli7a lief rthio^t 
llllUalULc lib I OUjcbl 


nn on 

Ull - cX) 


Public 


N 


Dll Insert 


Incprt olamont in liet 
It loci I clclilciu in llol 


nn 01 
uu - ci 


Public 


N 


DIIInsertFirst 

Vll II Ivvl U II wl 


Mskp plpmpnt firet 

IVIQAC Civil (CI 11 III ol 


nn . 

uu • £0 


Public 


Y 


DIIIsEmDtv 


Rphirn Tn ip if liet omnh/ 
nciuiii i iuc ii uol ciiiuiy 


nn - os 

Ull * cD 


Public 


Ife 


DIILelClientCount 


Vicit fimrtinn* f^nunt plpmpnte mnHitinnafh/ 

VIOH lUllwUUil. UUUItL CiCIIICI 110 l/UI lUJLIUf Mill y 


mi . or 

UH cD 


Public 




DIILelClientRnd 


X/icit eparrh fiin^tinn* all plpmpnte 

VIOH OCCUwII lUllwUWII. GUI CmwIIICiiiO 


nn - oft 

Ull CO 


Public 


N 


DIILelClientFirst 


Return client of first element 


DII-30 


Public 


Y 


Hilt rtl^l!n«I^AtkUk 


Return Nth client 


DII-31 


Public 


N 


OIILeiClientLast 


Return client of last element 


Dil-33 


Public 


Y 


DIILelClientVisitBwd 


Visit function: all elements 


DII-34 


Public 


N 


DIILelClientVisitFwd 


Visit function: all elements 


DII-36 


Public 


N 


DIINotifyCutRange 


Cut elements 


DII-38 


Friend 


N 


DIINotifyPasteRange 


Paste elements 


DII-39 


Friend 


N 


DIIPasteRangeAfter 


Paste element(s) to list 


DII-40 


Public 


N 


DilPasteRangeBefore 


Paste element(s) in list 


DII-42 


Public 


N 


DIlPasteRangeRrst 


Paste elements) to be first in list 


DII-44 


Public 


Y 


DIIPasteRangeLast 


Paste elements) to end of list 


DII-46 


Public 


Y 


DIISendDestroy 


Send message for list destruction 


CHI -48 


Public 


N 
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Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


DIIAppend 


Append element to list 


DII-2 


N 


DIIAppendLast 


Make element last 


Dll -4 


N 


DHCIear 


Clear the list 


DII-7 


N 


DilCut 


Cut one element from list 


DII-8 


N 


DllCutChildren 


Cut all elements from list 


Dll - 10 


N 


DIlCutRange 


Cut element(s) from list 


Dll -11 


N 


DilDetnit 


Deinitialize list object 


Dil -13 


N 


DIIDestroy 


Deinitialize list object and free space 


Dll - 14 


N 


DIIGetClient 


Return client of list 


Dll -15 


N 


DIIGetSize 


Get size of list 


Dll -19 


N 


Dlllnit 


Initialize list object 


Dll -20 


N 


Dlltnsert 


Insert element in list 


Dll -21 


N 


DIIInsertFirst 


Make element first 


Dil - 23 


N 


DlllsEmpty 


Return True if list empty 


Dll -25 


N 


DOLelClientCount 


Visit function: count elements conditionally 


Dll -26 


N 


DIILelCiientRnd 


Visit search function* all plpments 


nil • ?r 


N 


DIILelClientFirst 


Return client of first element 


Dll -30 


N 


DIILelClientGetNth 


Return Nth client 


Dll - 31 


N 


DBLelClientLast 


Return client of last element 


Dll -33 


N 


DIILelClientVisitBwd 


Visit function: all elements 


Dll -34 


N 


DIILelClientVisitFwd 


Visit function: all elements 


Dll -36 


N 


DIIPasteRangeAfter 


Paste element(s) to list 


Dll -40 


N 


DliPasteRangeBefore 


Paste elements) in list 


Dll -42 


N 


DliPasteRangeRrst 


Paste elements) to be first in list 


Dll -44 


N 


DIIPasteRangeLast 


Paste elements) to end of list 


Dll -46 


N 


DliSendDestroy 


Send message for list destruction 


Dll -48 


N 




Private Functions 






Function Name 


Description 


Page 


Macro 


DtlAsObj 


Return list as object 


Dll -6 


N 


DHGetRrst 


Return first element 


Dll -16 


N 


DIIGetLast 


Return last element 


Dll -17 


N 


DflGetNth 


Return Nth element 


Dll -18 


N 



Undocumented Functions 



None 
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Friend Functions 



Function Name 


Description 


Page 


Macro 


DIlNotifyCutRange 


Cut elements 


011-38 


N 


DllNotifyPasteRange 


Paste elements 


Oil -39 


N 



Listing Of Functions by Category 

Edit Functions 

Function Name Description Page Scope Macro 



DIIAppend 


Append element to list 


Dll -2 


Public 


N 


DIIAppendLast 


Make element last 


DII-4 


Public 


Y 


DOCIear 


Clear the list 


DII-7 


Public 


N 


DllCut 


Cut one element from list 


Oil -8 


Public 


N 


DHCutChildren 


Cut all elements from list 


Oil - 10 


Public 


N 


DIICutRange 


Cut element(s) from list 


DII-11 


Public 


N 


Dlllnsert 


Insert element in list 


Dll -21 


Public 


N 


DlllnsertRrst 


Make element first 


Dil-23 


Public 


Y 


DIlNotifyCutRange 


Cut elements 


Dll -38 


Friend 


N 


DllNotifyPasteRange 


Paste elements 


Dll -39 


Friend 


N 


DIIPasteRangeAfter 


Paste element(s) to list 


Dl! -40 


Public 


N 


DIlPasteRangeBefore 


Paste elements) in list 


DII-42 


Public 


N 


DIIPasteRangeFirst 


Paste elements) to be first in list 


Dll -44 


Public 


Y 


DIIPasteRangeLast 


Paste elements) to end of list 


DII-46 


Public 


Y 



Superclass Functions 
Function Name Description Page Scope Macro 



DIIAsObj 


Return list as object 


Dll-6 


Private 


Y 



Initialization Functions 

Function Name Description Page Scope Macro 



DIIDelnit 


Deinitialize list object 


Dll - 13 


Public 


N 


DIIDestroy 


Deinitialize list object and free space 


Dll - 14 


Public 


N 


Dlllnit 


Initialize list object 


Dll - 20 


Public 


N 


DDSendDestroy 


Send message for list destruction 


Dll -48 


Public 


N 



Summary of Dll - 7 



List 



Query Functions 



Function Name 


DescrlDtion 

•WWW > J* MWI ■ 


Pane 


Scope Macro 


DIIGetClient 


Return client of list 


DII-15 


Public 


Y 


DIIGetFirst 


Return first element 


Dll -16 


Private 


v 
Y 


DDGetLast 


Return last element 


DII-17 


Private 


Y 


OIIGetNth 


Return Nth element 


Dll -18 


Private 


N 


DHGetSize 


Get size of list 


Dll • 19 


Public 


N 


DlllsEmpty 


Return True if list empty 


Dll -25 


Public 


! Y 


DIILelClientCount 




mi - 9R 


Public 


I N 


DIILelClientFind 


Visit search function: all elements 


Dll -28 


Public 


N 


DHLelClientRrst 


Return client of first element 


Dll -30 


Public 


Y 


DIILelClientGetNth 


Return Nth client 


Dll -31 


Public 


N 


DIILelClientLast 


Return client of last element 


Dll -33 


Public 


Y 




Visit Functions 








Function Name 


Description 


Pan a 


Scope Macro 


OIILelClientVisitBwd 


Visit function: all elements 




Public 


N 


DOLelClientVisitFwd 


Visit function: all elements 


mi . 

Ull 00 


Public 


N 


Listing Of Functions With Macros Available 








Function Name 


Description 




Scope 




DIIAppendLast 


Make element last 


Dll -4 


Public 




DHAsObj 


Return list as object 


Oil* 6 


Private 




DIIGetClient 


Return client of list 


DII-15 


Public 




DIlGetRrst 


Return first element 


Dll - 16 


Private 




OIIGetUst 


Return last element 


DII-17 


Private • 




DMnsertfirst 


Make element first 


DU-23 


Public 




DlllsEmpty 


Return True if list empty 


Dll -25 


Public 




DULelClientFirst 


Return client of first element 


Dll -30 


Public 




DHLelClientLast 


Return client of last element 


Dll -33 


Public 




DIIPasteRangeFirst 


Paste elements) to be first in list 


Dll -44 


Public 




DIIPasteRangeLast 


Paste elements) to end of list 


Dll -46 


Public 
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Structure Name: 



DynamicArray 
Dpa 

Primitive 



Abbreviation: 



Class Type: 



Introduction 

The DynamicArray is a class for structuring data as an array of pointers such 
that elements can be quickly accessed by an index. The array in this case is 
dynamic, since it can grow and shrink at will. The next version of C+O will 
change the name DynamicArray to DynamicPointerArray. Please refer to the 
DynamicArray as Dpa when writing a program. 

Applications of DynamicArray include graphical object arrays, text editor line 
display lists, stacks, queues, etc. 

Because DynamicArray is a primitive class, it cannot inherit nor can it be 
inherited. A future version of C+O may change that. 

Description 

An array is a set of pairs, index and value. For each index which is defined, 
there is a value associated with that index. This is known as a mapping. The 
values in the DynamicArray class are 16 bit or 32 bit pointers (depending on 
memory model). Figure 1 shows an array of 6 elements with values A B, C, D, 
E and F. The first element in the array A is at index zero. 



0 12 3 4 5 




Figure 1 
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While elements of the array are not required to point to objects of the same 
class, DynamicArray is more valuable if they do. No loss of generality is 
encountered by doing this since the array element may point to a common 
abstract object type. Individual objects can then be of any subclass of the 
abstract type. (See section on classes for more details.) 

While the array of elements may grow or shrink, the location of a 
DynamicArray object never changes. The array is grown or shrunk in multiples 
of a user specified value, thus changing the logical size of the array does not 
always result in a resizing of the physical array. 

Glossary and Special Terms 

The number of elements in an array is the size of the array. Figure 2 shows an 
array with 4 elements A, B, C and D. The size of the array is therefore 4. 




size=4 



nipjBiD 



Figure 2 



A range of array elements is defined as a beginning element and an ending 

element. Figure 3 shows an array with size 8. Possible valid ranges of 
elements are: 

1) 0 through 7, here the range spans A, B, C, D, E, F, G, H. 2) 2 through 4, 
here the range spans elements C, D and E. 3) 5 through 5, here the range 
spans one element, F. 

Possible invalid ranges of list elements are: 

1) 4 through 0, here the range is backwards. 2) 0 through 8, here the range 
spans outside the array. 



B 



E F II G H 



Figure 3 
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A regi n of array elements is defined as a beginning element and a c unt from 
the beginning element. Figure 4 shows an array with size 8. Possible valid 
regions of array elements are: 

1) A with count 8, here the region is from first to last. 2) C with count 3, here 
the region spans elements C, D and E. 3) F with count 1, here the range spans 
one element, F. 

Possible invalid regions of list elements are: 

1) E with count 0, here the number of elements is less than 1. 2) C with count 
9, here the count spans outside the array. 



D|D|B|D|Q|D|Q|D| 



Figure 4 
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Class Implementation DynamicArray 



Instance Variables 

The following is the data structure definition for an array. 

struct DynamicArray { Medium I nt dpaCheck; 

ClientRtr *array; 

Mediumlnt size; 

Mediumlnt allocSize; 

Mediumlnt increment; } 

dllCheck Uniquely identifies List instances, 

array Holds the array values, 

size Logical size of array. 

allocSize Allocated size of array, 

increment Amount to grow the array by. 

Superclasses 

The DynamicArray class does not inherit from any other classes. 

Class Variables 

The DynamicArray class has no class instance variables. 
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Function Listing In Alphabetic Order 



Function Name 


Description 


Pane 


Scope Macro 


DpaAppend 


Append an element 


Doa -2 


Public 


N 


DpaOear 


Clear dynamic array 


Doa-4 


Public 


N 


DpaCount 


Visit function: count True returns 


Doa -5 


Public 


N 


DpaCountRange 


Visit function: range with return checking 


Doa -7 


Public 


N 


DpaDelnit 


OeiniSalize the dynamic arrav obiect 


Dpa - 9 


Public 


N • 


DpaDelete 


Delete elements) 


Dpa - 10 


Public 


N 


DpaDestroy 


Deinitialize arrav obiect and free SDace 


Dpa -12 


Public 


N 


DpaExpand 


Paste Null elements) into array 


Dpa - 13 


Public 


N 


DpaRnd 


Find index returning True 


Dpa - 15 


Public 


N 


DpaRndPtrBwd 


Find index with matching pointer 


Dpa - 17 


Public 


N 


DpaFindPtrFwd 


Find index with matching pointer 


Dpa - 19 


Public 


N 


DpaFindRangeBwd 


Find index retumino True for ranoe 


Dpa -21 


Public 


N 


DpaFindRangeFwd 


Rnd index returning True for range 


Dpa -23 


Public 


N 


DpaGetLast 


Return last element in arrav 


Dpa -27 


Public 


N 


DpaGetNth 


Return Nth arrav element 


Dpa - 25 


Public 


N 


DpaGetSize 


Return number of elements 


Dpa -29 


Public 


N 


Opalnit 


Initialize the edoe obiect 


Dna -31 


Public 


N 


DpaNewArray 


Create a new array 


N/A 


Undoc 


N 


upanesize 


Resize the array 


N/A 


Undoc 


N 


DpaSetNth 


Set Nth element of array 


Dpa -33 


Public 


N 


DpaSetRegionNull 


Make region of elements Null 


Dpa -35 


Public 


N 


DpaSetSize 


Set array size to N elements 


Dpa -37 


Public 


N 


DpaShiftDown 


Shift down N elements in array 


Dpa-38 


Public 


N 


DpaShiftUp 


Shift up N elements in array 


Dpa -40 


Public 


N 


DpaVisit 


Visit function: all elements 


Dpa -42 


Public 


N 


DpaVisitClient 


Visit function: all elements 


Dpa -44 


Public 


N 


DpaVisitRange 


Visit function: range of elements 


Dpa -46 


Public 


N 


DpaVisitRegion 


Visit function: region of elements 


Dpa-48 


Public 


N 


DpaVisitSelfAndSuccessors 


Visit function: client and successors 


Dpa -50 


Public 


N 
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Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


DpaAppend 


Append an element 


Dpa-2 


N 


DpaClear 


Clear dynamic array 


Dpa-4 


N 


DpaCount 


Visit function: count True returns 


Dpa-5 


N 


DpaCountRange 


Visit function: range with return checking 


Dpa-7 


N 


DpaDelnit 


Deinitialize the dynamic array object 


Dpa-9 


N 


DpaDelete 


Delete elements) 


Dpa-10 


N 


DpaDestroy 


Deinitialize array object and free space 


Dpa-12 


N 


DpaExpand 


Paste Null elements) into array 


Dpa-13 


N 


OpaRnd 


Rnd index returning True 


Dpa-15 


N 


DpaRndPtrBwd 


Rnd index with matching pointer 


Dpa-17 


N 


DpaRndPtrFwd 


Rnd index with matching pointer 


Dpa-19 


N 


DpaFindRangeBwd 


Rnd index returning True for range 


Dpa-21 


N 


DpaRndRangeFwd 


Rnd index returning True for range 


Dpa-23 


N 


DpaGetLast 


Return last element in array 


Dpa-27 


N 


DpaGetNth 


Return Nth array element 


Dpa-25 


N 


OpaGetSize 


Return number of elements 


Dpa-29 


N i 


Dpalnit 


Initialize the edge object 


Dpa-31 


N 


DpaSetNth 


Set Nth element of array 


Dpa-33 


N 


DpaSetRegionNul! 


Make region of elements Null 


Dpa-35 


N 


DpaSetSize 


Set array size to N elements 


Dpa-37 


N 


DpaShiftDown 


Shift down N elements in array 


Dpa-38 


N 


DpaShiftUp 


Shift up N elements in array 


Dpa-40 


N 


DpaVisit 


Visit function: all elements 


Dpa-42 


N 


DpaVisitClient 


Visit function: all elements 


Dpa-44 


N 


DpaVisitRange 


Visit function: range of elements 


Dpa-46 


N 


DpaVisitRegion 


Visit function: region of elements 


Dpa-48 


N 


DpaVisitSelfAndSuccessors 


Visit function: client and successors 


Dpa-50 


N 



Private Functions 



None 









Undocumented Functions 



Function Name 


Description 


Page 


Macro 


DpaNewArray 


Create a new array 


N/A 


N 


DpaResize 


Resize the array 


N/A 


N 
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Friend Functions 



None 









Listing Of Functions by Category 

Edit Functions 



Function Name 


Description 


Page 


Scope Macro 


OpaAppend 


Append an element 


Dpa-2 


Public 


N 


DpaClear 


Clear dynamic array 


Dpa-4 


Public 


N 


DpaDelete 


Delete elements) 


Dpa-10 


Public 


N 


D6'Expand 


Paste Null element(s) into array 


Dpa-13 


Public 


N 


DpaNewAnray 


Create a new array 


N/A 


Undoc 


N 


DpaResize 


Resize the array 


N/A 


Undoc 


N 


DpaSetNth 


Set Nth element of array 


Dpa-33P 


Jbiic 


N 


DpaSetRegionNull 


Make region of elements Null ' 


Dpa-35 


Public 


N 


PpaSetSize 


Set array size to N elements 


Dpa-37 


Public 


N 


DpaShiftDown 


Shift down N elements in array 


Dpa-38 


Public 


N 


OpaShiftUp 


Shift up N elements in array 


Dpa-40 


Public 


N 



Query Functions 



Function Name 


Description 


Page 


Scope Macro 


DpaCount 


Visit function: count True returns 


Dpa-5 


Public 


N 


DpaCountRange 


Visit function: range with return checking 


Dpa-7 


Public 


N 


DpaFind 


Find index returning True 


Dpa-15 


Public 


N 


DpaFindPtrBwd 


Find index with matching pointer 


Dpa-17 


Public - 


N 


DpaFindPtrFwd 


Find index with matching pointer 


Dpa-19 


Public 


N 


DpaFindRangeBwd 


Find index returning True for range 


Dpa-21 


Public 


N 


DpaFindRangeFwd 


Find index returning True for range 


Dpa-23 


Public 


N 


DpaGetLast 


Return last element in array 


Dpa-27 


Public 


N 


DpaGetNth 


Return Nth array element 


Dpa-25 


Public 


N 


DpaGetSize 


Return number of elements 


Dpa-29 


Public 


N 
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Initializati n Functions 



Function Name 


Description 


Page 


Scope Macro 


DpaDelnit 


Deinitiatize the dynamic array object 


Dpa-9 


Public 


N 


DpaDestroy 


Deiniiialize array object and free space 


Dpa -12 


Public 


N 


Dpalnit 


Initialize the edge object 


Dpa -31 


Public 


N 




Visit Functions 








Function Name 


Description 


Page 


Scope Macro 


Dpa Visit 


Visit function: all elements 


Dpa -42 


Public 


N 


DpaVisitClient 


Visit function: all elements 


Dpa -44 


Public 


N 


DpaVisitRange 


Visit function: range of elements 


Dpa-46 


Public 


N 


DpaVisitRegion 


Visit function: region of elements 


Dpa-48 


Public 


N 


DpaVisitSelfAndSuccessors 


Visit function: client and successors 


Dpa -50 


Public 


N 



Listing Of Functions With Macros Available 



None 


» 
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Class Description for Edge 



Structure Name: 



Edge 
Edg 

Inheritable class 



Abbreviation: 



Class Type: 



Introduction 

An Edge is a only a useful object in the context of a graph and vertices. Edges 
can be subclassed to represent for example, relationships between activities in 
a critical path application, interdependencies between cells in a spreadsheet, 
links in a hypertext document, etc. 

The Edge class has two friend classes Vertex and Graph. The documentation for 
the Edge class should therefore be read in conjunction with the classes Vertex 
and Graph. 

Description 

An edge connects two vertices. An edge has a tail and a head. The vertex 
connected to the tail is the incoming vertex and the vertex connected to the 
head is the outgoing vertex. In an undirected graph, these distinctions are 
meaningless. In Figure 1 below the edge x has the outgoing vertex A and the 
incoming vertex B. 



Outgoing 
Vertex 




Figure 1 
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Edge 



Glossary and Special Terms 

The predecessor vertex of an edge is its incoming vertex and the successor 

vertex is its outgoing vertex. Similarly, the successor vertices of a Vertex A are 
the vertices at the head of the outgoing edges of A. The predecessor vertices of 
A are the vertices at the tail end of the incoming edges of A. See Figure 2. 



Incoming Edge 




Outgoing Edge 



Figure 2 



Class Implementation Edge 



Instance Variables 

The following is the data structure definition for a edge In a directed graph. 



struct Edge { 



obj 

edgCheck 
grfLel 
inLel 
outLel 

Superclasses 
lype 

ListElement 
ListElement 
ListElement 



Obj 

Mediumlnt 
Lei 
Lei 
Lei 



obj; 

edgCheck; 

grfLel; 

inLel; 

outLel; }; 



Gives Edge class object-oriented properties of inheritance 

and dynamic binding. 

Uniquely identifies Edge instances. 

List element in a graph. 

List element of incoming edges for a vertex. 

List element of outgoing edges for a vertex. 



Name 

GrfLel 

InLel 

OutLel 



Description 

Connects edge to graph 
Connects edge to incoming vertex 
Connects edge to outgoing vertex 



Messages and Responses 
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Messages and Responses 

Edge overrides the destroy message from all three of its ListEtement 
superclasses. The implementation of the destroy message is handled by 
EdgDestroy. Subclasses of Edge should override the destroy message. 



Selector Method 
destroy EdgDestroy 
Class Variables 



Type 

Mcl 

Medium Int 
Medium I nt 
Medium Int 



Name 

EdgMcl 

EdgGrfLelOffset 

EdglnLelOffset 

EdgOutLelOffset 



Description 

Destroy the object 

Description 

Metaclass decription for Edge. 
Client offset of Edge from superclass 
GrfLel 

Client offset of Edge from superclass 
InLel 

Client offset of Edge from superclass 
OutLel 
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Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 





OaH irn apoaK liet aIari Ant fnr aH/ia 

neiui ii grapn iisl element lor euge 


PHa . 0 

cog - c 


menu 


v 

T 


PHa Acini ol 


OaH ifn InA/xminn aH/ya liet a 1 Am Ant 

neiurn ii rcuiTiHig euge iisi element 


PHa . 4 

cog • o 


CriAnH 

rnena 


V 
T 




Rati irn aHna oe nhtoM 

neiuTii euge as uujcci 


PHa .A 

cuy • «t 


Drii/otA 

rnvaie 


IN 




Rah im At itnninrt oHnn liet a! am Ant 

neiurn uuiguiiig euge iisi eienieni 


PHn - 5 

cog -o 


PnAnH 

menu 


Y 
T 




Ploaf tha aHaa 

vlcai ine euge 


PHa -ft 

cog • o 


Pi iKHa 
rUDHC 


M 
IN 


cuy vaj 1 1 1 pal c i( i v ia 


Pnfnnora SnAAminA i/aHav 


PHn . 7 

cog • / 


Pi ihliA 
rUDHC 


M 
IN 


PHAf^nnAAKTAf^rf 


PrtnnoM aHaa tn /vranh 

connect eage to grapn 


PHa 0 

tag -y 


rUDHC 


V 
T 


PHA^AnnAAtTnV/Ai+irAc 

cug vunr lcci i o venicco 


r^rtnna^t aHna t*v »*ArtiAoc . 

uonneci cage to vertices 


PHa 1 1 

tag - 1 1 


Di ihlir> 

ruoiic 


hi 


PHa Ho 1 nit 

cog l/c mil 


ftAinittafivA fa a aHaa nhiAAt 

ueiniiiaiize uie eage oojeci 


PHa 13 

tag - io 


rUDHC 


M 
IN 


cuyucoiiuy 


f^AinitiolWA oHno nKiA/*t QnH Itaa cmao 

ueiniuaiize euge oojeci ana iree space 


PHa 1A 

tag - i«t 


rUDHC 


M 
IN 


P Hn Hi cm n noAt Pr a mr*^rf 

cuy uibcui ii rocirr uni 


riiennnnA/»t oHno fmm nronn 

uisconneci eage irorn grapn 


PHa 1 R 

tag • id 


Di iKti/* 

rUDHC 


v 

T 


cuy uiswi if tocirrorn vertices 


uisconneci eage irom vemces 


EHn 17 

tag - 1 / 


Di iKIS/« 
rUDHC 


hi 
IM 


EdgGetClient 


Return client of edge 


Edg-19 


Public 


Y 


EdgGetGrf 


Return graph 


Edg-20 


Friend 


Y 


EdgGetlnVtx 


Return incoming vertex 


Edg-21 


Friend 


Y 


EdgGetNextln 


Return next incoming edge 


Edg-23 


Friend 


Y 


EdgGetNextOut 


Return next outgoing edge 


Edg-25 


Friend 


Y 


EdgGetOutVlx 


Return outgoing vertex 


Edg-27 


Friend 


Y 


EdgGetVertices 


Return vertices to edge 


Edg-29 


Public 


Y 


EdgHasVertices 


Does edge have any vertices 


Edg-31 


Public 


N 


EdglnGrf 


Is edge in graph 


Edg-32 


Public 


Y 


Edglnit 


Initialize the edge object 


Edg-33 


Public 


N 


EdgSendDestroy 


Send message for edge destruction 


Edg-34 


Public 


Y 


EdgUpdatelnVtx 


Replace incoming vertex 


Edg-35 


Public 


N 


EdgUpdateOutVtx 


Replace outgoing vertex 


Edg-37 


Public 


N 
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Function Listing By Scope 

Public Functions 



Function Name 


Descrlnttan 


Doha 
"aye 


Marrn 


EdaClear 


Hlpar thp pHna 


Pdn - R 
cuy - o 


M 


FdnComrarplnVtx 


VsVlMpOJC 11 HAJI Hilly VUIIOA 


PHn - 7 
cuy * / 


M 


EdgConnectToGrf 


Connect edge to graph 


Edg -9 


H 


EdgConnectToVertices 


Connect edge to vertices 


Edg -11 


N 


EdgDelnit 


Deinitialize the edge object 


Edg -13 


N 


Edg Destroy 


Deinitialize edge object and free space 


Edg - 14 


N 


EdgDisconnectFromGrf 


Disconnect edge from graph 


Edg - 15 


N 


EdgDisconnectFromVertices 


Disconnect edge from vertices 


Edg -17 


N 


EdgGetClient 


Return client of edge 


Edg - 19 


N 


EdgGetVertices 


Return vertices to edge 


Edg -29 


N 


EdgHasVertices 


Does edge have any vertices 


Edg -31 


N 


EdglnGrf 


Is edge in graph 


Edg -32 


N 


Edglnit 


Initialize the edge object 


Edg -33 


N 


EdgSendDestroy 


Send message for edge destruction 


Edg -34 


N 


EdgUpdatelnVtx 


Replace incoming vertex 


Edg -35 


N 


EdgUpdateOutVtx 


Replace outgoing vertex 


Edg -37 


N 




Private Functions 






Function Name 


Description 


Page 


Macro 


EdgAsObj 


Return edge as object 


Edg-4 


N 



Undocumented Functions 



None 
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Friend Functions 



Function Name 


Description 


Page 


Macro 


EdgAsGrfLel 


Return graph list element for edge 


Edg-2 


N 


EdgAslnLel 


Return incoming edge list element 


Edg-3 


N 


EdgAsOutLel 


Return outgoing edge list element 


Edg-5 


N 


EdgGetGrt 


Return graph 


Edg-20 


N 


EdgGetlnVtx 


Return incoming vertex 


Edg-21 


N 


EdgGetNextln 


Return next incoming edge 


Edg-23 


N 


EdgGetNextOut 


Return next outgoing edge 


Edg-25 


N 


EdgGelOutVtx 


Return outgoing vertex 


Edg-27 


N 



Listing Of Functions by Category 

Superclass Functions 



Function Name 


Description 


Page 


Scope Macro 


EdgAsGrfLel 


Return graph list element for edge 


Edg-2 


Friend 


Y 


EdgAslnLel 


Return incoming edge list element 


Edg-3 


Friend 


Y 


EdgAsObj 


Return edge as object 


Edg-4 


Private 


N 


EdgAsOutLel 


Return outgoing edge list element 


Edg-5 


Friend 


Y 




Edit Functions 








Function Name 


Description 


Page 


Scope Macro 


EdgCiear 


Clear the edge 


Edg-6 


Public 


N 


EdgConnectToGrf 


Connect edge to graph 


Edg-9 


Public 


Y 


EdgConnectToVertices 


Connect edge to vertices 


Edg-11 


Public 


N 


EdgDisconnectFromGrf 


Disconnect edge from graph 


Edg-15 


Public 


Y 


EdgDisconnectFromVertices 


Disconnect edge from vertices 


Edg-17 


Public 


N 


EdgUpdatelnVtx 


Replace incoming vertex 


Edg-35 


Public 


N 


EdgUpdateOutVtx 


Replace outgoing vertex 


Edg-37 


Public 


N 
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Query Functions 



Function Name 


Description 


Page 


Scope Macro 


EdgComparelnVtx 


Compare incoming vertex 


Edg-7 


Public 


N 


EdgGetClient 


Return client of edge 


Edg-19 


Public 


Y 


EdgGetGrf 


Return graph 


Edg-20 


Friend 


Y 


EdgGetlnVtx 


Return incoming vertex 


Edg-21 


Friend 


Y 


EdgGetNextln 


Return next incoming edge 


Edg-23 


Friend 


Y 


EdgGetNextOut 


Return next outgoing edge 


Edg-25 


Friend 


Y 


EdgGetOutVtx 


Return outgoing vertex 


Edg-27 


Friend 


Y 


EdgGetVertices 


Return vertices to edge 


Edg-29 


Public 


Y 


EdgHasVertices 


Does edge have any vertices 


Edg-31 


Public 


N 


EdglnGrf 


Is edge in graph 


Edg-32 


Public 


Y 



Initialization Functions 



runcuon Name 


uescnption 


Page 


Scope Macro 


EdgDelnit 


Deinitialize the edge object 


Edg-13 


Public 


N~ 


EdgDestroy 


Deinitialize edge object and free space 


Edg-14 


Public 


N 


Edglnit 


Initialize the edge object 


Edg-33 


Public 


N 


EdgSendDestroy 


Send message for edge destruction 


Edg-34 


Public 


Y 


Listing Of Functions With 


Macros Available 








Function Name 


Description 


Page 


Scope 




EdgAsGrfLel 


Return graph list element for edge 


Edg -2 


Friend 




EdgAslnLel 


Return incoming edge list element 


Edg-3 


Friend 




EdgAsOutLel 


Return outgoing edge list element 


Edg-5 


Friend 




EdgConnectToGrf 


Connect edge to graph 


Edg-9 


Public 




EdgDisconnectFromGrf 


Disconnect edge from graph 


Edg - 15 


Public 




EdgGetClient 


Return client of edge 


Edg-19 


Public 




EdgGetGrf 


Return graph 


Edg-20 


Friend 




EdgGetlnVtx 


Return incoming vertex 


Edg-21 


Friend 




EdgGetNextln 


Return next incoming edge 


Edg-23 


Friend 




EdgGetNextOut 


Return next outgoing edge 


Edg-25 


Friend 




EdgGetOutVtx 


Return outgoing vertex 


Edg-27 


Friend 




EdgGetVertices 


Return vertices to edge 


Edg-29 


Public 




EdglnGrf 


Is edge in graph 


Edg-32 


Public 




EdgSendDestroy 


Send message for edge destruction 


Edg-34 


Public 
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Class Description for Graph 



Structure Name: 



Graph 
Grf 



Abbreviation: 



Class Type: 



Inheritable class 



Introduction 

Graphs are used for a variety of applications. Some of these applications are: 
analysis of electrical circuits, finding shortest routes, analysis of project 
planning, identification of chemical compounds, statistical mechanics, 
genetics, cybernetics, CASE tools, etc. Of all mathematical structures, graphs 
are the most widely used. 

The Graph class has two friend classes Vertex and Edge. The documentation for 
the Graph class should therefore be read in conjunction with the classes Vertex 
and Edge. 

Description 

A graph consists of a set of vertices and a set of edges, where each edge is a 
pair of distinct vertices. 

Graph can deal with directed graphs or digraphs. In a directed graph each 
edge is represented by a directed pair of vertices, and the edges are drawn with 
an arrow from the tail to the head. A graph can have multiple occurances of the 
same edge (i.e. two edges with identical predecessor and successor vertices), it 
is up to the client of Graph to determine whether this should be allowed. In 
Figure 1 below the graph G contains the vertices A, B, C, D, and the edges a, b, 
c, d, e, f. 




Graph G 



Figure 1 
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Glossary and Special Terms 

A vertex can have incoming edges and outgoing edges. In Figure 2 below the 
vertex A has an incoming edge x, and an outgoing edge y. 



An edge connects two vertices. An edge has a tail and a head. The vertex 
connected to the tail is the incoming vertex and the vertex connected to the 
head is the outgoing vertex. In an undirected graph, these distinctions are 
meaningless. In Figure 3 below the edge x has the outgoing vertex A and the 
incoming vertex B. 

The predecessor vertex of an edge is its incoming vertex and the successor 

vertex is its outgoing vertex. Similarly, the successor vertices of a Vertex A are 
the vertices at the head of the outgoing edges of A. The predecessor vertices of 
A are the vertices at the tail end of the incoming edges of A. See Figure 3. 



A graph without cycles is acyclic. A cycle is a path of edges that return back 
to the starting point. In Figure 4 below the graph G, which has vertices A, B, C. 
and edges x, y, z, has a cycle and is, therefore, not acyclic. 



Incoming Edge 




Figure 2 



Outgoing Edge 




Incoming 



Figure 3 




Figure 4 



Summary of Grf - 2 



Graph 



Class Implementation Graph 



Instance Variables 

Hie following is the data structure definition for a directed graph. 



struct Graph { 



Obj 

Mediumlnt 

Dll 

Dll 

Dpa 

Dpa 



obj; 

grfCheck; 
vtxList; 
edgList; 
forwardSort; 
backwardSort; } 



obj 

grfCheck 

vtxList 

edgList 

forwardSort 

backwardSort 

Superclasses 

Type 

List 
Ust 



Allows Graph to inherit and be inherited. 
Uniquely identifies Graph instances. 
List of Vertices. 
List of Edges. 

Array storing vertices in forward topological order. 
Array storing vertices in backward topological order. 



Name 

VtxDII 
EdgDII 



Description 

List of vertices 
List of edges 



Messages and Responses 



Graph overrides the destroy message from both of its List superclasses. The 
implementation of the destroy message is handled by GrfDestroy. The subclass 
should override this message. 



Selector Method 
destroy GrfDestroy 
Class Variables 



Type 

Mcl 

Mediumlnt 



Name 

GrfMcl 

GrfVtxDIIOffset 



Mediumlnt GrfEdgDIIOffset 



Description 

Destroy the object 

Description 

Metaclass decription for Graph. 
Client offset of Graph from superclass 
VtxDII 

Client offset of Graph from superclass 
EdgDII 
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Function Listing In Alphabetic Order 



ruiiwuuii naiiic 


uescnpuon 


rage 


Scope Macro 


unAnywycies 


onecK grapn tor cycles 


\2U - 2 


Public 


Y 


rtrf A eCHrt nil 


neturn usr ot edges 


Grf-4 


Friend 


N 




neturn grapn as oojeci 


van - o 


Private 


N 


CrfAc\/tYnil 


neturn L/sr of vemces 


-o 


Friend 


N 


uriDdSlC l opoioyiCaloon 


uo topological son ot grapn 


MM 

IM/A 


Undoc 


N 




uear tne grapn 


Gil-/ 


Public 


N 


orTuounitag 


Count edges of graph 


Grf -8 


Public 


Y 


unUOUniViX 


Count vertices of graph 


Grf -10 


KUDHC 


v 
Y 


GrfDelnit 


Deinitialize Graph object 


Grf -12 


Public 


N 


GrfDestroy 


Deinitialize Graph object and free space 


Grf -13 


Public 


N 


GrfDoTopologicalSort 


Do topological sort of graph 


Grf -14 


Public 


Y 


GrfFindEdgClient 


Visit search function: edges 


Grf -16 


Public 


N 


GrfRndVtxClient 


Visit search function: vertices 


Grf -18 


Public 


N 


GrfGetClient 


Return client of graph 


Grf-20 


Public 


N 


Grflnit 


Initialize Graph object 


Grf -21 


Public 


N 


GrfSendDestroy 


Send message for graph destruction 


Grf-22 


Public 


N 


GrfVisitEdgClient 


Visit function: edges 


Grf-23 


Public 


N 


GrfVisitVtxClient 


Visit function: vertices 


Grf -25 


Public 


N 


GifVisitVtxClientlnTopOrderBwd 


Visit function: backward topological order 


Grf -27 


Public 


N 


GrfVisitVtxClientlnTopOrderFvyd 


Visit function: forward topological order 


Grf-29 


Public 


N 



Function Listing By Scope 

Public Functions 

Function Name Description Page Macro 



GrfAnyCycles 


Check graph for cycles 


Grf- 


2 


N 


GrfClear 


Clear the graph 


Grf- 


7 


N 


GrfCountEdg 


Count edges of graph 


Grf- 


8 


N 


GrfCountVtx 


Count vertices of graph 


Grf- 


10 


N 


GrfDelnit 


Deinitialize Graph object 


Grf- 


■12 


N 


GrfDestroy 


Deinitialize Grapn object and free space 


Grf- 


•13 


N 


GrfDoTopologicalSort 


Do topological sort of graph 


Grf- 


■14 


N 


GrfFindEdgClient 


Visit search function: edges 


Grf- 


•16 


N 


GrfRndVtxClient 


Visit search function: vertices 


Grf- 


18 


N 


GrfGetClient 


Return client of graph 


Grf- 


20 


N 


Grflnit 


Initialize Graph object 


Grf- 


21 


N 
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Graph 



Public Functions (cont) 



Function Name 


Description 


Page 


Macro 


GrfSendDestroy 


Send message for graph destruction 


Grf-22 


N 


GrfVisitEdgClient 


Visit function: edges 


Grf-23 


N 


GrfVisitVtxClient 


Visit function: vertices 


Grf-25 


N 


GrfVisitVtxClientlnTopOfderBwd 


Visit function: backward topological order 


Grf-27 


N 


GrfVisitVtxClientlnTopOrderFwd 


Visit function: forward topological order 


Grf-29 


N ' 




Private Functions 






Function Name 


Description 


Page 


Macro 


GrfAsObj 


Return graph as object 


Grf-5 


N 


Undocumented Functions 






Function Name 


Description 


Page 


Macro 


GrfBasicTopologicalSort 


Do topological sort of graph 


N/A 


N 




Friend Functions 






Function Name 


Description 


Page 


Macro 


GrfAsEdgOIl 


Return List of edges 


Grf-4 


N 


GrfAsVtxDII 


Return Ust of vertices 


Grf-6 


N 


Listing Of Functions by Category 








Query Functions 






Function Name 


Description 


Page Scope 


Macro 



GrfAnyCycles 


Check graph for cycles 


Grf-2 


Public 




Y 


GrfCountEdg 


Count edges of graph 


Grf-8 


Public 




Y 


GrfCountVtx 


Count vertices of graph 


Grf-10 


Public 




Y 


GrfFindEdgClient 


Visit search function: edges 


Grf-16 


Public 




N 


GrfFindVtxClient 


Visit search function: vertices 


Grf-18 


Public 




N 


GrfGetCIient 


Return client of graph 


Grf-20 


Public 




N 



Summary of Grf-5 
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Superclass Functions 

Function Name Description Page Scope Macro 



GrfAsEdgDII 


Return List of edges 


Grf-4 


Friend 


N 


GrfAsObj 


Return graph as object 


Grf-5 


Private 


N 


GrfAsVtxDII 


Return Ust of vertices 


Grf-6 


Friend 


N 




Process Functions 








Function Name 


Description 


Page 


Scope Macro 


GrfBasicTopologicalSort 


Do topological sort of graph 


N/A 


Undoc 


N 


GrfDoTopologicalSorl 


Do topological sort of graph 


Grf-14 


Public 


Y 




Edit Functions 








Function Name 


Description 


Page 


Scope Macro 


GrfClear 


Clear the graph 


Grf-7 


Public 


N 



Initialization Functions 



Function Name Description Page Scope Macro 



GrfDelnit 


Deinitialize Graph object 


Grf-12 


Public 




N 


GrfDestroy 


Deinitialize Graph object and free space 


Grf-13 


Public 




N 


Grflnit 


Initialize Graph object 


Grf-21 


Public 




N 



Initialization Functions 



Function Name 


Description 


Page 


Scope Macro 


GrfSendDestroy 


Send message for graph destruction 


Grf-22 


Public 


N 
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Graph 



Visit Functions 



Function Name 


Description 


Page 


Scope Macro 


GrfVisitEdgCIient 


Visit function: edges 


van - Zo 


Public 


N 


GrfVisitVtxClient 


Visit function: vertices 


bn- 25 


Public 


N 


GrfVisitVlxClientlnTopOrderBwd 


Visit function: backward topological order 


Can - 27 


Pi ihttr 

rUOilC 


M 


GrfVisitVtxClientlnTopOrderFwd 


Visit function: forward topological order 


Grf-29 


Public 


N 


Listing Of Functions With Macros Available 








Function Name 


Description 


Page 


Scope 




GrfAnyCycles 


Check graph for cycles 


Grf-2 


Public 




GrfCountEdg 


Count edges of graph 


Grf-8 


Public 




GrfCountVtx 


Count vertices of graph 


Grf-10 


Public 




GrfDoTopologicalSort 


Do topological sort of graph 


Grf-14 


Public 
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Class Description for JulianTime 



Structure Name: JulianTime 
Abbreviation: Jul 
Class Type: Primitive 



Introduction 

The JidianTime class is used for modeling and manipulating calendar dates. It 
is best suited for applications where the calculations involving the arithmetical 
calculation of dates are more frequent than the formatting of dates for display. 

The formatting functions provided by JulianTime are somewhat on the weak 
side. This class is really designed for date calculations. Future releases of this 
class will improve on its formatting capabilities. 

Description 

The JulianTime class provides functions for representing a specific day of a 
year as a Julian date. A Julian date is the number of days that have elapsed 
since noon GMT on January 1, 4713 BC. This is the Julian day number. The 
consecutive numbering of days makes the system independent of the length of 
a month or year and is optimal for doing many date calculations. 
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JulianTime 



Glossary and Special Terms 

Julian Day Number: 

The number of days that have elapsed since noon GMT on January 1, 4713 
BC. 

Example - Julian day on March 1st. 

1940 = 2429690 

1980 = 2444300 

1990 = 2447952 

Date Format: 

JulianTime functions with formating arguments use an enum DateFormat as 
the argument. These format identifiers are as follows: 

United States format MM-DD-YYYY has the enum DFJJS. 

European format DD-MM-YYYY has the enum DF_EUROPE. 

Military format YYYY-MM-DD has the enum DF__MILITARY. 

The algorithm implemented for the Julian day conversion is valid for the 
Gregorian calendar. Valid years are therefore 1583 AD to 4713 AD. 

Class Implementation JulianTime 

Instance Variables 

The structure definition for JulianTime is as follows: 
struct JulianTime { ULargelnt time;} 

time Julian day number. 
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Class Variables 

The following class variables are used by the JulianTime class: 

The class variable monthSize contains the size of each month of the year. The 
size of the second month (February) is preset to be a non leap year. 

Mediumlnt monthSize[1 2] = {31 ,28,31 ,30,31 ,30,31 ,31 ,30,31 ,30,31 } ; 

The class variable quarterSize contains the size of each quarter of the year. 

Mediumlnt quarterSize[4] = {90,91,92,92}; 

The class variable weekMonthName contains the strings to be used to create 
the date string in the JulWeekString function. 

Char weekMonthName[12][4] = { "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", 
"Sep", "O 60"Nov", "Dec" }; 

The class variable MonthName contains the strings to be used to create the 
date string in the JulMonthString function. 

Char MonthName[12][4] = { "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", 
"Oct", 60"Dec" }; 

The class variable QuarterName contains the strings to be used to create the 
date string in the JulQuarterString function. 

Char QuarterName[4][8] = { "1st Qtr", "2nd Qtr", "3rd Qtr", "4th Qtr }; 
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Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 



.liilAHHDav^ 


AHH/ci ihtrart Have fn Ha to 


ini 

Jul 


* c 


Pi ihlir* 
rUUlIU 


v 

T 




AHH/ci thtrart Have tn Hato flAnnl 
nUU/oUUUaUl Uay o 10 Ualc UUliyj 


llll 

JUI 


• *r 


Pi ihlir 
rUOilw 


V 
T 


JulAddMonths 


AHH/ci ihtrart mrtnthc tn Hato 


JUI 




Pi ihlir 
rUUlIU 


M 


Jul AdriOi jartprc 

vUlnUUMUul Iwl o 


AHH/ci thtraot ni tartorc tn Ha to 


till . 

JUI 


. ft 
* 0 


Pi ihlir 


M 
IN 


Ji il AHHYparc 


AHH/ci ihtrart vaarc tn Hoto 
MUU/oUOuawl ycaiS 10 Ualc 


till 
Jul 


• 10 


Pi iKtir 
rUDIIC 


M 
IN 


Ii ilf^alonHarTri lulinn 
JUiwcUcllUai 1 OJUHail 


uay, moron, year to juiian oay 


In! 
JUI 


10 

■ 1* 


rUDIIC 


N 


.It iinnnv 


r\\nu ii ilion Ha v 

vsooy juiidM oay 


lilt 
JUi 


m m 


Pi ihlir 
rUDIIC 


V 
T 


JUJUalCOU 1 OJUIian 


uaie Suing 10 juiian oay 


JUI 


• 10 


rUDIIC 


K.I 
N 


JUI UayVJ 1 1 v Wfv 


uay nun i Dei in ween 


Ini 
JUI 


• 10 


Di iWi/» 

rUDIIC 


v 

T 


juiuaywi i ecu 


uay numoer in year 


Ini 
JUI ' 


Oft 


rUDIIC 


M 
IN 


h ilDavclnMAnth 

JUI Lrayoll IIVIUI ill 1 


Uayo in mown 


h ii 
JUI 


00 


Di iKIi^ 

rUDIIC 


M 

IN 


h tirtavclnfti iartor 
jui uay o 1 1 iwucu ic i 


uay s in quarier 


Ini 
JUI • 


OA 


Dt iMi/% 
rUDIIC 


Kl 
IN 


JUlUaySinTccir 


uays in year 


Ini 
JUI 


oc 


rUDIIC 


N 


JUIUIII 


uays oeiween iwo oaies 


JUI • 


on 
• do 


D< iKtiV 
rUDIIC 


v 
T 


luiniff] 


r^oviO hafmoan Ium /fatac /l/\nn\ 

uays oeiween two oaies (*ongj 


Ini 

JUI ' 


Qft 


rUDIIC 


v 
Y 


.Ii iN^Pt^vctom lifliannav 
JUIVSCiw jSttsi llwUUcU lUoy 


oysiem uaie as juiian oay 


till 
JUI • 


10 


Di iKH/* 

rUDIIC 


KJ 
IN 


Jultnit 

Will II lit 


oci 10 ocyiiiiiiiig oi caienoar January i, 1000 


till 

JUI 




Pi iWia 
rUDIIC 


v 

T 


JullsLeapYear 


Is date in leap year 


Jul- 


•36 


Public 


N 


JullsMaxValue 


Is date maximum juiian value 


Jul 


■38 


Pubfic 


Y 


JulMax 


The maximum of two juiian dates 


Jul 


•40 


Public 


Y 


JulMin 


The minimum of two juiian dates 


Jul 


•42 


Public 


Y 


JulMonthDayDiff 


Days between date and a day/month 


Jul 


•44 


Public 


N 


JulMonthString 


RO string with month and year 


Jul 


•46 


Public 


N 


JuIQuarterString 


Rll string with quarter and year 


Jul 


■48 


Public 


N 


JulSameDayMonth 


Two dates same day and month 


Jul- 


•50 


Public 


N 


JulSetMaxDate 


Set date to maximum value 


Jul 


■52 


Public 


N 


JulToCalendar 


Julian day to day, month, year 


Jul- 


•54 


Public 


N 


JulToDateStr 


Rll date string of specified format 


Jul 


•56 


Public 


N 


JulValidateDate 


Validate date passed as string 


Jul 


•58 


Public 


N 


JulWeekSlring 


Rll string with day and month 


Jul- 


•60 


Public 


N 


JulYearString 


Rll string with year 


Jul- 


-62 


Public 


N 
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Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


JulAddDays 


Add/subtract davs to date 


Jul -2 

VUl *» 


N 

11 


JulAddDaysL 


Add/subtract davs to date flona) 


Jul -4 


N 
ii 


JulAddMonths 


Add/subtract months to date 


Jul -6 


N 
ii 


JulAddQuarters 


Add/subtract Quarters to date 


Jul -8 


N 
ii 


JulAddYears 


Add/subtract vears to date 


Jul -10 

VUl IV 


N 
ii 


JulCalendarToJulian 


Dav month vear to iulian dav 


Jul - 12 

VUl 1 


N 
ii 


JlllCODV 


Conv iulian dav 


Jul - 14 

vul It 


N 


JulDateStrToJuIian 


Date strina to iulian dav 


Jul - 16 

VUl 1 W 


N 
ii 


JutDavOfWeek 


Dav number in week 

I^WT 1 lUlllvwl III llvwli 


Jul - 18 


N 
ii 


JuIDavOfYear 


Dav number in vear 

WMf IIUIIIWvl III WWW 


Jul - 20 

WUI fcV 


N 
ii 


JulDaysInMonth 


Days in month 


Jul - 22 


N 


JulDayslnQuarter 


Davs in Quarter 

W 1 Will WWWI iwl 


Jul - 24 


N 
ii 


JuIDavslnYear 


Dav^ in vpar 

L/CIJw III JGwJ 


Jul - 2fi 

vUl tvl 


ii 


JulDiff 


Davs between two dates 


Jul -28 


N 


JulDiffL 


Davs between two dates Mono) 


Jul - 30 


N 
ii 


JutGetSystemJuIianDay 


Svstem date as iulian dav 


Jul - 32 


N 
ii 


Jullnit 


Set to beainnina of calendar Januarv 1 1 583 

*^W* *w wVNio M Ml »VJ VI VUIWI Ivw WM lUU' W t | 1 WWW 


Jul -34 


N 


JullsLeapYear 


Is date in leap year 


Jul -36 


N 


Jul ism ax value 


Is date maximum julian value 


Jul -38 


N 


JulMax 


The maximum of two julian dates 


Jul -40 


N 


JulMin 


The minimum of two julian dates 


Jul -42 


N 


JulMonthDayDiff 


Days between date and a day/month 


Jul -44 


N 


JulMonthString 


Fill string with month and year 


Jul -46 


N 


JulQuarterString 


nil string with quarter and year 


Jul -48 


N 


JulSameDayMonth 


Two dates same day and month 


Jul -50 


N 


JulSetMaxDate 


Set date to maximum value 


Jul -52 


N 


JuIToCaiendar 


Julian day to day, month, year 


Jul -54 


N 


JulToDateStr 


Fill date string of specified format 


Jul -56 


N 


JulValidateDate 


Validate date passed as string 


Jul -58 


N 


JulWeekString 


Fill string with day and month 


Jul -60 


N 


JuIYearString 


nil string with year 


Jul -62 


N 



Private Functions 



None 
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Undocumented Functions 



None 








Friend Functions 


None 









Listing Of Functions by Category 

Arithmetical Functions 



Function Name 


Description 


Page 


Scope Macro 


JulAddOays 


Add/subtract days to date 


Jul -2 


Public 


V 


JulAddOaysL 


Add/subtract days to date (long) 


Jul-4 


Public 


Y 


JulAddMonths 


Add/subtract months to date 


Jul -6 


Public 


N 


JulAddQuarters 


Add/subtract quarters to date 


Jul -8 


Public 


N 


JulAddYears 


Add/subtract years to date 


Jul -10 


Public 


N 


JulDiff 


Days between two dates 


Jul -28 


Public 


Y 


JulOiffL 


Days between two dates (long) 


Jul -30 


Public 


Y 


JuJinit 


Set to beginning of calendar January 1 , 1 583 


Jul -34 


Public 


Y 


JulMax 


The maximum of two julian dates 


Jul -40 


Public 


Y 


JulMin 


The minimum of two julian dates 


Jul -42 


Public 


Y 


JulMonthDayDiff 


Days between date and a day/month 


Jul -44 


Public 


N 



Conversion Functions 
Function Name Description Page Scope Macro 



JulCalendarToJulian 


Day, month, year to julian day 


Jul 


-12 


Public 


N 


JulDateStrToJulian 


Date string to julian day 


Jul 


-16 


Public 


N 


JulGetSystemJulianDay 


System date as julian day 


Jul 


-32 


Public 


N 


JulToCalendar 


Julian day to day, month, year 


Jul 


-54 


Public 


N 


JulValidateDate 


Validate date passed as string 


Jul 


-58 


Public 


N 
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Miscellaneous Functions 

Function Name Description Page Scope Macro 



JulCopy 


Copy julian day 


Jul -14 ■ 


Public 




Y 


JulSetMaxDate 


Set date to maximum value 


Jul -52 


Public 




N 



Query Functions 



Function Name 


Description 


Page 


Scope Macro 


JulDayOfWeek 


Day number in week 


Jul -18 


Public 


Y 


JulDayOfYear 


Day number in year 


Jul -20 


Public 


N 


JulDayslnMonth 


Days in month 


Jul - 22 


Public 


N 


JulOayslnQuarter 


Days in quarter 


Jul -24 


Public 


N 


JulDayslnYear 


Days in year 


Jul -26 


Public 


N 


JullsLeapYear 


Is date in leap year 


Jul -36 


Public 


N 


JullsMaxValue 


Is date maximum julian value 


Jul -38 


Public 


Y 


JulSameDayMonth 


Two dates same day and month 


Jul -50 


Public 


N 



Formatting Functions 



Function Name 


Description 


Page 


Scope Macro 


JulMonthString 


Fill string with month and year 


Jul -46 


Public 


N 


JulQuarterString 


Fill string with quarter and year 


Jul-48 


Public 


N 


JulToDateStr 


Rll date string of specified format 


Jul -56 


Public 


N 


JulWeekString 


Fill string with day and month 


Jul -60 


Public 


N 


JulYearString 


Rll string with year 


Jul -62 


Public 


N 


Listing Of Functions With Macros Available 








Function Name 


Description 


Page 


Scope 




JulAddDays 


Add/subtract days to date 


Jul -2 


Public 




JulAddDaysL 


Add/subtract days to date (long) 


Jul -4 


Public 




JulCopy 


Copy julian day 


Jul -14 


Public 




JulDayOfWeek 


Day number in week 


Jul -18 


Public 




JulDiff 


Days between two dates 


Jul -28 


Public 




JulDiffL 


Days between two dates (long) 


Jul -30 


Public 




Jullnit 


Set to beginning of calendar January 1, 1583 


Jul -34 


Public 




JullsMaxValue 


Is date maximum julian value 


Jul -38 


Public 




JulMax 


The maximum of two julian dates 


Jul -40 


Public 




JulMin 


The minimum of two julian dates 


Jul -42 


Public 
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Class Description for ListElement 



Structure Name: 



ListElement 



Abbreviation: 



Lei 



Class Type: 



Inheritable class 



Introduction 

The ListElement class has a friend class List The documentation for the 
ListElement class should therefore be read in conjunction with the List class. 

When sequential mapping is used for ordered lists, achieved using an array 
data structure, operations such as insertion and deletion of arbitrary elements 
become expensive because of the amount of data movement. Linked 
representations of ordered lists are an alternative to sequential 
representations. 

Description 

Unlike a sequential representation where successive items of a list are located 
a fixed distance apart, in a linked representation these items may be placed 
anywhere in memory. Each element points to the next element in the list and 
the previous element in that list. These elements are stored as part of the class 
ListElement. 

Besides the linked items a special node exists called the head node. The head 
node stores the first and last elements in the list. C+O stores the head node as 
part of the class List. ListElements also store a pointer to the List they belong to 
(if any). 

It is customary to draw linked lists as an ordered sequence of nodes with links 
being represented by arrows. Figure 1 shows a sample doubly linked list with 4 
nodes {ListElements] A, B, C and D. The head node [List) points to nodes A and 
D. 




Figure 1 



Summary of Lei - 1 
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The List class is the data structure representation of the head node. The 
ListElernent class is the data structure representation of a single element in a 
doubly linked list. 



Glossary and Special Terms 

Figure 2 shows the first and last element in a doubly linked list. Because each 
list element stores a pointer to the List class ( head node ) the first and last 
elements are also accessible from each element. 

To get from the first element to the last element you would access successor, 
or next elements. To get from the last element to the first element you would 
access predecessor or previous elements. 

The predecessor of the first element is NULL. The successor to the last element 
is NULL. All other elements will have non-NULL predecessors and successors. 
There exists only zero or one predecessor for a given element. 




Figure 2 



A range of list elements is defined as a beginning list element and an ending 
list element. Figure 3 shows a doubly linked list with size 8. 

Examples of a valid range of list elements: 

1) A through H, here the range is from first to last. 2) C through E, here the 
range spans elements C, D and E. 3) F through F, here the range spans one 
element, F. 
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Examples of an Invalid range of list elements: 

1) E through A, here the range is backwards. 2) A through I, here the range 
spans outside the list. 




Figure 3 



Class Implementation ListElement 



Instance Variables 



The following is the data structure definition for a list element. 

struct ListElement { Obj obj; 

Mediumlnt lelCheck; 

PDLL pDII; 

PLEL prev; 

PLEL next; } 

obj Gives ListElement class properties of inheritance and 

dynamic binding. 
lelCheck Uniquely identifies ListElement instances. 

pDll Pointer to List that the ListElement belongs to. 

prev Previous ListElement in the list, 

next Next ListElement in the list. 
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Messages and Responses 

The implementation of the destroy message is handled by LelDestroy but 

should be overridden by the subclass. The destroy message is not used by any 
Lei methods. 

Selector Method Description 

destroy LelDestroy Destroy the object 
Class Variables 

Type Name Description 

Mci LeIMcl Metaclass description for ListElement 



Summary of Lei - 4 



ListElement 



Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 



LeIAsObj 


Return element as object 


Lei 


■2 


Private 


Y 


LeICIientCount 


Return count for client and successors 


Lei 


•3 


Public 


N 


LelClientOII 


Return client of list 


Lei 


■5 


Public 


Y 


LeiClientRndRange 


Visit search function: range 


Lei 


•6 


Public 


N 


LelOientNext 


Return client of next element 


Lei 


■8 


Public 


Y 


LeICIientPrev 


Return client of previous element 


Lei 


•9 


Public 


Y 


LeICIientVisitBwd 


Visit function; client and predecessors 


Lei 


•10 


Public 


N 


LelOientVisitFwd 


Visit function: client and successors 


Lei 


•12 


Public 


N 


LeICIientVisitPredecessors 


Visit function: predecessors 


Lei 


•14 


Public 


N 


LeOentVisitRange 


Visit function: range 


Lei ■ 


-16 


Public 


N 


LeOentVisitSuccessors 


Visit function: successors 


Lei 


•18 


Public 


N 


LeICountRange 


Count elements 


Lei - 


•20 


Public 


N 


LeICut 


Cut element from list 


Lei- 


22 


Public 


N 


LeICutRange 


Cut element(s) from list 


Lei- 


24 


Public 


N 


LelCutRangeFromList 


Cut elementjs) from list 


N/A 




Undoc 


N 


LeIDelnit 


Deinitialize list element object 


Lei 


26 


Public 


N 


LeIDestroy 


Deinitialize list element object and free space 


Lei - 


27 


Public 


N 


LeIGetClient 


Return client 


Lei- 


28 


Public 


Y 


LelGetCHI 


Return list object 


Lei - 


29 


Friend 


Y 


LeIGetNext 


Return next element 


Lei - 


30 


Friend 


Y 


LeIGetNthSuccessor 


Return Nth element 


Lei- 


31 


Friend 


N 


LeIGetPrev 


Return previous element 


Lel- 


32 


Friend 


Y 


Lellnit 


Is element in list 


Lel- 


33 


Public 


N 


LeIPasteRangeAfter 


Append elements(s) to list 


Lel- 


34 


Public 


N 


LeIPasteRange Before 


Insert elements) to list 


Lel- 


36 


Public 


N 


LeIPasteRangeToList 


Insert elements) to list 


N/A 




Undoc 


N 


LeISendDestroy 


Send message for list element destruction 


Lel- 


38 


Public 


N 


LeITest 


Test for valid list element 


Lel- 


39 


Public 


N 


LeIVisitRange 


Visit function for range 


Lel- 


40 


Private 


N 
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Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


LeICIientCount 


Return count for client and successors 


Lei -3 


N 


LeICIientDII 


Return client of list 


Lei -5 


N 


LeICIientRndRange 


Visit search function: range 


Lei -6 


N 


LelQientNext 


Return client of next element 


Lei -8 


' N 


LeICIientPrev 


Return client of previous element 


Lei -9 


N 


LeICIientVisitBwd 


Visit function: client and predecessors 


Lei -10 


N 


LeOentVisitFwd 


Visit function: client and successors 


Lei -12 


N 


LeoentvisitPredecessors 


Visit function: predecessors 


Lei - 14 


N 


LeICIientVisitRange 


Visit function: range 


Lei • 16 


N 


LeICIientVisitSuccessors 


Visit function: successors 


Lei -18 


N 


LeICountRange 


Count elements 


Lei -20 


N 


LeICut 


Cut element from list 


Lei -22 


N 


LeicuiRange 


Cut element(s) from list 


Lei - 24 


N 


LeIDelnit 


Deinitialize list element object 


Lei -26 


N 


LeIDestroy ( 


Deinitialize list element object and free space 


Lei -27 


N 


LeiGetuient 


Return client 


Lei • 28 


N 


Lellnit 


Is element in list 


Lei -33 


N 


LeIPasteRangeAfter 


Append elements(s) to list 


Lei -34 


N 


LeIPasteRangeBefore 


Insert elements) to list 


Lei - 36 


N 


LeISendDestroy 


Send message for list element destruction 


Lei -38 


N 


LeITest 


Test for valid list element 


Lei - 39 


LI 

N 




Private Functions 






Function Name 


Description 


Page 


Macro 


LeIAsObj 


Return element as object 


Lei -2 


N 


LeIVisitRange 


Visit function for range 


Lei -40 


N 


Undocumented Functions 






Function Name 


Description 


Page 


Macro 


LeICutRangeFromList 


Cut element(s) from list 


N/A 


N 


LeIPasteRangeToList 


Insert elements) to list 


N/A 


N 
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ListElement 



Friend Functions 



Function Name Description Page Macro 



LeIGetDJI 


Return list object 


Lei 


■29 


N 


LeIGetNext 


Return next element 


Let 


•30 


N 


LeIGetNthSuccessor 


Return Nth element 


Lei 


■31 


N 


LeIGetPrev 


Return previous element 


Lei 


•32 


N 



Listing Of Functions by Category 

Superclass Functions 



Function Name 


Description 


Pag 


e 


Scope Macro 


LelAsObj 


Return element as object 


Lei 


•2 


Private 


Y 




Query Functions 










Function Name 


Description 


Pag 


e 


Scope Macro 


LelClientCount 


Return count for client and successors 


Lei 


•3 


Public 


N 


LeICIientDII 


Return client of list 


Lei 


■5 


Public 


Y 


LelClientFmdRange 


Visit search function: range 


Lei 


•6 


Public 


N 


LelQientNext 


Return client of next element 


Lei 


•8 


Public 


Y 


LelQientPrev 


Return client of previous element 


Lei 


•9 


Public 


Y 


LeICountRange 


Count elements 


Lei 


•20 


Public 


N 


LeIGetClient 


Return client 


Lei 


■28 


Public 


Y 


LelGetDII 


Return list object 


Lei 


•29 


Friend 


Y 


LeIGetNext 


Return next element 


Lei 


■30 


Friend 


Y 


LeIGetNthSuccessor 


Return Nth element 


Lei 


•31 


Friend 


N 


LeIGetPrev 


Return previous element 


Lei 


•32 


Friend 


Y 


Lellnit 


Is element in list 


Lei 


•33 


Public 


N 



Visit Functions 



Function Name 


Description 


Page 


Scope Macro 


LelClientVisitBwd 


Visit function: client and predecessors 


Lei -10 


Public 


N 


LeICIientVisitFwd 


Visit function: client and successors 


Lei -12 


Public 


N 


LelCIientVisitPredecessors 


Visit function: predecessors 


Lei -14 


Public 


N 


LeICIientVisitRange 


Visit function: range 


Lei - 16 


Public 


N 


LelClienMsitSuccessors 


Visit function: successors 


Lei -18 


Public 


N 


LeIVisitRange 


Visit function for range 


Lei -40 


Private 


N 
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ListEIement 



Edit Functions 



Function Name 


Description 


Page 


Scope Macro 


LeICut 


Cut element from list 


Lei -22 


Public 


N 


LeICutRange 


Cut element(s) from list 


Lei -24 


Public 


N 


LelCutRangeFromList 


Cut element(s) from list 


N/A 


Undoc 


N 


LeIPasteRangeAfter 


Append elements(s) to list 


Lei -34 


Public 


N 


LeIPasteRangeBefore 


Insert elements) to list 


Lei -36 


Public 


N 


LelPasteRangeToList 


Insert element(s) to list 


N/A 


Undoc 


N 



Initialization Functions 
Function Name Description Page Scope Macro 



LeIDelnit 


Deinitialize list element object 


Lei -26 


Public 


N 


LeIDestroy 


Deinitialize list element object and free space 


Lei -27 


Public 


N 


LeISendDestroy 


Send message for list element destruction 


Lei -38 


Public 


N 




Debug Functions 








Function Name 


Description 


Page 


Scope Macro 


LeITest 


Test for valid list element 


Lei -39 


Public 


N 


Listing Of Functions With Macros Available 








Function Name 


Description 


Page 


Scope 




LeIAsObj 


Return element as object 


Lei -2 


Private 




LelClientDU 


Return client of list 


Lel-5 


Public 




LeICIientNext 


Return client of next element 


Lei -8 


Public 




LeICIientPrev 


Return client of previous element 


Lei -9 


Public 




LeIGetCtient 


Return client 


Lei -28 


Public 




LeIGetDII 


Return list object 


Lei -29 


Friend 




LeIGetNext 


Return next element 


Lei -30 


Friend 




LeIGetPrev 


Return previous element 


Lei -32 


^Friend 
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Class Description for MetaClass 



Structure Name: 



MetaClass 



Abbreviation: 



Mcl 



Class Type: 



Primitive Class 



Introduction 

MetaClasses are used to create objects of type Class. By analogy, a MetaClass 
is to a Class, what a Class is to an Object While ultimately it is Objects 
(instantiations of some structure or type) which we are interested in, we start 
by defining an instance of MetaClass. 

Whenever you define a structure (class) which you want to have the object- 
oriented properties of inheritance or dynamic binding, you must do three 
things and in the following order. 

First, the structure must contain, as the first structure member, a structure of 
type Object. Objects allow you to send messages (dynamic binding) and access 
subclasses (a class which inherits from your structure). 

Second, you must define and initialize an instance of the structure MetaClass 
which describes the Class, its messages, and its superclass (classes which 
your class inherits from). Normally you will initialize the MetaClass instance at 
compile time. 

Third, your program must call MclSendCreateClass, passing the MetaClass 
instance you defined in Step 2. The return value is (a pointer to) an instance of 
Class. 

Now your program can create objects (memory allocated for the structure) of 
the Class you defined by calling ClsCreateObject and passing the pointer 
returned by MclSendCreateClass. When an object is no longer needed, you call 
ObjDestroy which deallocates the memory for that object. 
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MetaClass 



MetaCloss, along with Class, Object, Message, MetaSuperClass, MetaMessage, 
and Block collectively define and implement the object-oriented properties of 
inheritance and dynamic binding (messaging) in C+O class libraries. 
Encapsulation, while supported by the above code, can be implemented by the 
programmer simply writing enough functions for a structure to obviate the 
need to access the structure members directly. These classes should be studied 
as a group to understand how C+O implements object-oriented C programs. 

For further information, read the tutorial section and also study the class 
header files dllcls.h, lelcls.h, and trecls.h. These headers define instances of 
MetaClass, MetaSuperClass and MetaMessage. 



Description 

An instance of MetaClass references an array of MetaSuperClasses and an 
array of MetaMessages. In its simplest form, an instance of MetaClass need 
only describe the name of the Class and the size of an object of that Class. 
Please refer to the sections on MetaMessage and MetaSuperClass for more 
information on defining instances of those classes. 

A MetaClass is used to define all the constant information about a structure; it 
defines its size, the messages it responds to, and its superclasses. 

The reader should famialiarize himself with the structure definition of 
MetaClass since you will be initializing instances of MetaMessage statically. 



Glossary and Special Terms 

There is no special glossary for MetaClass. Instead, refer to the tutorial section 
on object-oriented techniques in C+O. 
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MetaClass 



Class Implementation MetaClass 



Instance Variables 

The following is the data structure definition for a directed graph. 



struct MetaClass { 



mclCheck 

name 

clsSize 

objSize 

mmsArray 

mmsSize 

mscArray 

mscSize 

createFunc 

destroyFunc 

Superclasses 



Mediumlnt mclCheck; 

PSTR name; 

Mediumlnt clsSize; 

Mediumlnt objSize; 

PMMS mmsArray; 

Mediumlnt mmsSize; 

PMSC mscArray; 

Mediumlnt mscSize; 

PCLS (*createFunc)(PMCL); 

Void (*destroyFunc)(PCLS); } 

Uniquely identifies MetaClass instances. 

Name 01 the structure being modeled. 

Size of the Class structure or extended Class structure 

Size of the structure being modeled. 

An array of MetaMessages. 

Number of MetaMessages in mmsArray. 

An array of MetaSuperClasses. 

Number of MetaSuperClasses. 

A function which will create a Class instance. 

A function which will destroy a Class instance. 



MetaClass has no superclasses. 

Messages and Responses 

MetaClass does not have any messages since it is a primitive class. 

Class Variables 



MetaClass has no class variables. 
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MetaClass 



Function Listing In Alphabetic Order 



Function Name 


Description 


Page 


Scope Macro 


MclCreateQass 


Create a class instance 


Mcl -2 


Private 


N 


MclDestroyClass 


Destroy a class instance 


Mcl-3 


Fripnd 

1 1 Ivl IU 


N 


MclRndSelector 


Find a selector index given its name 


Mcl-5 


Public 


N 


MclFindSuperCiass 


Find the superclass index given its name 


Mcl-6 


Public 


N 


MclGetClassName 


Get the class name 


Mcl-7 


Public 


N 


MclGetClassSize 


Return the size of a class instance 


Mcl-8 


Public 


N 


MclGetMessageCount 


Return the number of messages 


Mcl-9 


Public 


N 


MclGetNthMms 


Return the Nth MetaMessage. 


Md-10 


Public 


N 


MclGetNthOffset 


Return the Nth Superclass offset 


Mcl -11 


Public 


N 


McIGetNthSuper 


Return the MetaClass 


Md- 12 


Public 


N 


MclGetSuperClassCount 


Return the number of superclasses 


Mcl-13 


Public 


N 


MclPrint 


Print the MetaClass instance 


Md-14 


Public 


N 


McISendCreateCIass 


Return a new instance of the MetaClass 


Md-15 


Public 


N 


MclSendDestroyClass 


Deallocate an instance of a Class 


Mcl-16 


Public 


N 


MdValidaie 


Validate that the instance is valid 


Mcl-17 


Public 


N 


MclValidateMessages 


Validate the MetaMessages 


N/A 


Undoc 


N 


MclValidateSuperdasses 


Validate the MetaSuperClasses 


N/A 


Undoc 


N 



Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


MclRndSelector 


Find a selector index given its name 


Mcl-5 


N 


MclFindSuperCiass 


Find the superclass index given its name 


Mcl-6 


N 


MclGetClassName 


Get the class name 


Mcl-7 


N 


MclGetClassSize 


Return the size of a class instance 


Mcl-8 


N 


MclGetMessageCount 


Return the number of messages 


Mcl-9 


N 


MclGetNthMms 


Return the Nth MetaMessage 


Md-10 


N 


MclGetNthOffset 


Return the Nth Superclass offset 


Md-11 


N 


McIGetNthSuper 


Return the MetaClass 


Md-12 


N 


MclGetSuperClassCount 


Return the number of superclasses 


Mcl-13 


N 


MclPrint 


Print the MetaClass instance 


Md-14 


N 


MclSendCreateClass 


Return a new instance of the MetaClass 


Md-15 


N 


MclSendDestroyClass 


Deallocate an instance of a Class 


Mcl - 16 


N 


MclValidate 


Validate that the instance is valid 


Mcl-17 


N 
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MetaClass 



Private Functions 



Function Name 


Description 


Page 


Macro 


MdCreateClass 


Create a class instance 


Mcl -2 


N 


Undocumented Functions 






Function Name 


Description 


Page 


Macro 


MclValidateMessages 


Validate the MetaMessages 


N/A 


N 


MclValidateSuperClasses 


Validate the MetaSuperClasses 


N/A 


N 




Friend Functions 






Function Name 


Description 


Page 


Macro 


MclDestroyClass 


Destroy a class instance 


Mcl -3 


N 



Listing Of Functions by Category 

Class Functions 

Function Name Description Page Scope Macro 



MdCreateClass 


Create a class instance 


Mcl 


•2 


Private 


N 


MclDestroyClass 


Destroy a class instance 


Mcl 


-3 


Friend 


N 


MclSendCreateClass 


Return a new instance of the MetaClass 


Mcl 


-15 


Public 


N 


MclSendDestroyClass 


Deallocate an instance of a Class 


Mcl 


-16 


Public 


N 




Query Functions 










Function Name 


Description 


Pag 


e 


Scope Macro 


MclFindSelector 


Find a selector index given its name 


Mcl 


-5 


Public 


N 


MdFindSuperClass 


Find the superclass index given its name 


Mcl 


-6 


Public 


N 


MclGetClassName 


Get the class name 


Mcl 


-7 


Public 


N 


MclGetClassSize 


Return the size of a class instance 


Mcl 


-8 


Public 


N 


MclGetMessageCount 


Return the number of messages 


Mcl 


-9 


Public 


N 


MclGetNthMms 


Return the Nth MetaMessage 


Mcl 


-10 


Public 


N 


MclGetNthOffset 


Return the Nth Superclass offset 


Mcl 


-11 


Public 


N 


MclGetNthSuper 


Return the MetaClass 


Mcl 


-12 


Public 


N 


MclGetSuperClassCount 


Return the number of superclasses 


Mcl 


-13 


Public 


N 
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MetaClass 



Debug Functions 



Function Name Description Page Scope Macro 



MdPrint 


Print the MetaClass instance 


Mcl-14 


Public 


N 


Invalidate 


Validate that the instance is valid 


Mcl-17 


Public 


N 


MclValidateMessages 


Validate the MetaMessages 


N/A 


Undoc 


N 


MclValidateSuperClasses 


Validate the MetaSuperClasses 


N/A 


Undoc 


N 



Listing Of Functions With Macros Available 



None 
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Class Description for Memory 



Structure Name: 



Memory 
Mem 



Abbreviation: 



Class Type: 



Primitive Class 



Introduction 

The Memory class is used to manipulate arrays of bytes. Each element can be 
an arbitrary number of bytes wide. It is used by the DynamicArray class to 
implement many low level functions. 

Description 

The Memory class is an abstract representation of raw, unstructured 
sequential bytes of memory. It is the most primitive class in C+O. Many other 
classes use Mem for allocation and deallocation of memory. 

Glossary and Special Terms 

There is no special glossary for this class. 



Class Implementation Memory 



Instance Variables 



Memory is implemented as a typedef Char Memory. 



Summary of Mem - 1 



Memory 



Superclasses 

The Memory class is primitive and has no superclasses. 

Messages and Responses 

The Memory class is primitive and has no messages. 

Class Variables 

The Memory class has no class variables. 



Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 



MemClear 


Clears array elements 


Mem -2 


Public 




N 


MemCopy 


Copy array elements within the array 


Mem -3 


Public 




N 


MemCutNSet 


Delete elements, shift remaining 


Mem -5 


Public 




N 


Mem Destroy 


Deallocate memory 


Mem -6 


Public 




N 


MemDuplicate 


Copy array into another 


Mem -7 


Public 




N 


MemNew 


Allocate memory 


Mem -8 


Public 




N 


MemPasteNSet 


Expand array, shift remaining 


Mem -9 


Public 




N 


MemSetChr 


Set elements to character 


Mem - 10 


Public 




N 



Function Listing By Scope 

Public Functions 

Function Name Description Page Macro 



MemClear 


Clears array elements 


Mem 


•2 


N 


MemCopy 


Copy array elements within the array 


Mem 


-3 


N 


MemCutNSet 


Delete elements, shift remaining 


Mem 


•5 


N 


MemDestroy 


Deallocate memory 


Mem 


■6 


N 


MemDuplicate 


Copy array into another 


Mem 


■7 


N 


MemNew 


Allocate memory 


Mem 


■8 


N 


MemPasteNSet 


Expand array, shift remaining 


Mem 


■9 


N 


MemSetChr 


Set elements to character 


Mem 


•10 


N 
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Memory 



Private Functions 



None 









Undocumented Functions 



None 











Friend Functions 






None 









Listing Of Functions by Category 

Array Functions 
Function Name Description 



Page Scope Macro 



MemClear 


Clears array elements 


Mem -2 


Public 


N 


MemCopy 


Copy array elements within the array 


Mem -3 


Public 


N 


MemCutNSet 


Delete elements, shift remaining 


Mem -5 


Public 


N 


MemDupGcate 


Copy array into another 


Mem -7 


Public 


N 


MemPasteNSet 


Expand array, shift remaining 


Mem -9 


Public 


N 


MemSetChr 


Set elements to character 


Mem -10 


Public 


N 


Initialization Functions 








Function Name 


Description 


Page 


Scope Macro 


MemDestroy 


Deallocate memory 


Mem -6 


Public 


N 


Mem New 


Allocate memory 


Mem -8 


Public 


N 


Listing Of Functions With Macros Available 


None 
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Class Description for Met a Message 



Structure Name: 



MetaMessage 
Mms 



Abbreviation: 



Class Type: 



Primitive Class 



Introduction 

A MetaMessage is a definition of a message. MetaMessages allow a MetaClass 
to create an instance of Message which describes the final mapping of a 
message to a function. 

Instances of MetaMessage are always declared and initialized as part of an 
array. The array is associated with an instance of MetaClass. 

MetaClass, along with Class, Object, Message, MetaSuperClass, MetaMessage, 
and Block collectively define and implement the object-oriented properties of 
inheritance and dynamic binding (messaging) in C+0 class libraries. 
Encapsulation, while supported by the above code, can be implemented by the 
programmer simply writing enough functions for a structure to obviate the 
need to access the structure members directly. These classes should be studied 
as a group to understand how C+O implements object-oriented C programs. 

For further information, read the tutorial section and also study the class 
header files dllcls.h, lelcls.h, and trecls.h. These headers define instances of 
MetaClass, MetaSuperClass and MetaMessage. 
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MetaMessage 



Description 

An instance of MetaMessage describes the selector (name) for the message, the 
method to execute for this message, and the superclass (if any) this message 
was defined by. 

The reader should famialiarize himself with the structure definition of 
MetaMessage since you will be initializing instances of MetaMessage statically. 

The following rules apply when defining instances of MetaMessage: 

1) If the method structure member is initialized to NULL and the superclass 
member is NULL, it means a subclass must implement the message. 

2) If the method structure member is initialized to NULL and the superclass 
member is not NULL, then the method is inherited from the superclass named. 
In this case, the MetaMessage serves the purpose of propagating the message 
to a subclass which can override it if it so chooses. 

3) If the method structure member is non-NULL and the superclass member is 
NULL it means the message originates from the class which owns this message. 
A subclass can override this message. 

4) If the method structure member is non-NULL and the superclass member is 
non-NULL it means the superclass method is being overridden, not only for 
this class, but the superclass being overriden. This occurs for each level of 
superclass where the message was being overridden. A subclass can override 
this message. 

5) If the method structure member is equal to the constant -1, it means we do 
not want to allow a subclass to override this message. Following this 
MetaMessage should be one which actually defines the message. 

8) If the same message selector is defined by two or more superclasses, you 
should define a MetaMessage for each one. In effect, both are handled * 
independently. This points out the advantage of an explicit inheritance 
mechanism where you must explicitly inherit messages from a superclass 
rather than have them "appear" automatically. 

9) If a subclass overrides a message, any following messages with the same 
selector are also overriden IF they have the same implementation, i.e., if the 
method structure member is identical. 

10) If there is more than one occurrence of a selector in the list of messages 
(because of identical selectors from different superclasses), the one nearest the 
top of the array will have priority over the others. This comes into play when 
looking up a message based on its selector string. 
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MetaMessage 



Glossary and Special Terms 

No special glossary exists for MetaMessage. Instead, refer to the tutorial 
section on object-oriented techniques. 

Class Implementation MetaMessage 



Instance Variables 

The following is the data structure definition for MetaMessage. 

struct MetaMessage { Mediumlnt mmsCheck; 

PSTR superClsName; 

PSTR selector; 

PMTH method; } 

mmsCheck Uniquely defines MetaMessage structures. 

superClsName Name of the superclass which also has this message 
selector Name of the message. 

method The function which (optionally) overrides the superclass 

method. 

Superclasses 

MetaMessage is a primitive class and has no superclasses. 

Messages and Responses 

MetaMessage is a primitive class and therefore has no messages. 

Class Variables 

MetaMessage has no class variables. 
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MetaMessage 



Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 



MmsGetMethod 


Get the method 


Mms-2 


Public 




N 


MmsGetSelector 


Get the name of selector 


Mms-6 


Public 




N 


MmsGetSuper 


Get name of superclass 


Mms -4 


Public 




N 


MmsPrint 


Display the instance 


Mms -7 


Public 




N 


MmsValidate 


Validate the instance 


Mms -8 


Public 




N 



Function Listing By Scope 

Public Functions 

Function Name Description Page Macro 



MmsGetMethod 


Get the method 


Mms- 


•2 


N 


MmsGetSelector 


Get the name of selector 


Mms- 


•6 


N 


MmsGetSuper 


Get name of superclass 


Mms- 


■4 


N 


MmsPrint 


Display the instance 


Mms 


7 


N 


MmsValidate 


Validate the instance 


Mms- 


•8 


N 



Private Functions 



None 









Undocumented Functions 



None 



Friend Functions 



None 
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MetaMessage 



Listing Of Functions by Category 

Query Functions 



Function Name 


Description 


Page 


Scope Macro 


MmsGetMethod 
MmsGetSelector 
MmsGetSuper 


Get the method 

Get the name of selector 

Get name of superclass 


Mms-2 
Mms-6 
Mms-4 


Public 
Public 
Public 


N 
N 
N 




Debug Functions 








Function Name 


Description 


Page 


Scope Macro 


MmsPrint 
MmsValidate 


Display the instance 
Validate the instance 


Mms-7 
Mms-8 


Public 
Public 


N 
N 


Listing Of Functions With Macros Available 


None 
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Class Description for MetaSuperClass 



Structure Name: 



MetaSuperClass 
Msc 



Abbreviation: 



Class Type: 



Primitive Class 



Introduction 

The class MetaSuperClass is used to describe the superclasses from which a 
class inherits from. Instances of MetaSuperClass are always declared and 
initialized as part of an array. 

Instances of MetaSuperClass are always initialized statically and is referenced 
by a single instance of MetaClass. 

MetaClass, along with Class, Object, Message, MetaSuperClass, MetaMessage, 
and Block collectively define and implement the object-oriented properties of 
inheritance and dynamic binding (messaging) in C+O class libraries. 
Encapsulation, while supported by the above code, can be implemented by the 
programmer simply writing enough functions for a structure to obviate the 
need to access the structure members directly. These classes should be studied 
as a group to understand how C+O implements object-oriented C programs. 

For further information, read the tutorial section and also study the class 
header files dllcls.h, lelcls.h, and trecls.h. These headers define instances of 
MetaClass, MetaSuperClass and MetaMessage. 
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MetaSuperClass 



Description 

An Instance of MetaSuperClass describes the name of a superclass, the type of 
the superclass, and the offset of the superclass from its subclass. 

When initializing an instance of MetaSuperClass, the name of each 
MetaSuperClass should be distinct from all other instances belonging to the 
MetaClass. 



Glossary and Special Terms 

There is no special glossary for MetaSuperClass. Instead, refer to the tutorial 
section on object-oriented techniques in C+O. 

Class Implementation MetaSuperClass 



Instance Variables 

The following is the data structure definition for a Class. 



struct MetaSuperClass { 



Mediumlnt 

PSTR 

PMCL 

POBJ 

POBJ 

Mediumlnt 



mscCheck; 

name; 

mcl; 

sublnstance; 
superlnstance; 
*offset; } 



mscCheck 

name 

mcl 

sublnstance 

superlnstance 

offset 



Superclasses 



Uniquely identifies MetaSuperClass instances. 
Name of superclass (overrides MetaClass name). 
MetaClass which describes the class being inherited. 
An example instance of the superobject. 
An example instance of the object. 

A pointer to Mediumlnt where the superclass offset should 
be stored. 



MetaSuperClass is a primitive class and has no superclasses 

Messages and Responses 

MetaSuperClass is a primitive class and has no messages 
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MetaSuperClass 



Class Variables 

MetaSuperClass has no class variables. 

Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 



MscGetMetaClass 


Get the MetaClass 


Msc-3 


Public 


N 


MscGetName 


Get the name of superclass 


Msc -2 


Public 


N 


MscGetOffset 


Get offset of superclass 


Msc-4 


Public 


N 


MscPrint 


Display the contents of the MetaSuperClass 


Msc-5 


Public 


N 


MscValidate 


Validate that the instance is valid 


Msc-6 


Public 


N 



Function Listing By Scope 

Public Functions 

Function Name Description Page Macro 



MscGetMetaClass 


Get the MetaClass 


Msc 


■3 


N 


MscGetName 


Get the name of superclass 


Msc 


•2 


N 


MscGetOffset 


Get offset of superclass 


Msc- 


•4 


N 


MscPrint 


Display the contents of the MetaSuperClass 


MSC 


•5 


N 


MscValidate 


Validate that the instance is valid 


Msc 


•6 


N 



Private Functions 



None 









Undocumented Functions 



None 



Friend Functions 



None 
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Listing Of Functions by Category 

Query Functions 



Function Name Description Page Scope Macro 


MscGetMetaClass 

MscGetName 

MscGetOffset 


Get the MetaClass 

Get the name of superclass 

Get offset of superclass 


Msc-3 
Msc-2 
MSC-4 


Public 
Public 
Public 


N 
N 
N 


Debug Functions 

Function Name Description Page Scope Macro 


MscPrint 
MscValidate 


Display the contents of the MetaSuperClass 
Validate that the instance is valid 


Msc-5 
Msc-6 


Public 
Public 


N 
N 


Listing Of Functions With 


Macros Available 



None 
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Structure Name: 



Message 
Msg 

Primitive Class 



Abbreviation: 



Class Type: 



Introduction 

The Message Class is responsible for sending messages to an object and 
passing the object client to the function. This class is used only by the class 
Class. You will never need to use this class unless you are writing Class 
functions. 

MetaClass, along with Class, Object, Message, MetaSuperClass, MetaMessage, 
and Block collectively define and implement the object-oriented properties of 
inheritance and dynamic binding (messaging) in C+O class libraries. 
Encapsulation, while supported by the above code, can be implemented by the 
programmer simply writing enough functions for a structure to obviate the 
need to access the structure members directly. These classes should be studied 
as a group to understand how C+O implements object-oriented C programs. 



Description 

When an object wishes to send a message, it identifies it by a message index or 
a message selector (name). The class then selects the appropriate message to 
route the message send to. Finally, an instance of Message invokes the proper 
method with a Block instance and passes an Object pointer. 
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Glossary and Special Terms 

There is no special glossary for Message. Instead, refer to the tutorial section 
on object-oriented techniques in C+O. 

Class Implementation Message 



Instance Variables 

The following is the data structure definition for an Object 
struct Message { 



Mediumlnt 
PCLS 
PMSG 
PCLS 
PSTR 
Mediumlnt 
PMTH 



msgCheck; 
els; 
superMsg; 
sub; 

se ector; 
offset; 
method; } 



msgCheck 
els 

superMsg 
sub 

selector 
offset 



Uniquely identifies instances of Message 
Class which implements this message 
Message which is being inherited/overridden 
Class which implements this selector 
String which identifies the message 

Object offset which will yield an object of the right class for 
this message 

Function which implements this message 



method 

Superclasses 

The Message class is primitive and has no superclasses. 

Messages and Responses 

The Message class is primitive and has no messages. 

Class Variables 

The Message class has no class variables. 
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Function Listing In Alphabetic Order 



Function Name 


Description 


Page 


Scope Macro 


MsgDelnil 


Deinit instance 


Msg* 2 


Public 


N 


MsgGetMethod 


Return method 


Msg -4 


Public 


N 


MsgGetOffset 


Return the object offset 


Msg-3 


Public 


N 


MsgGetSelector 


Return selector 


Msg -5 


Public 


N 


Msglnit 


Initialize instanc 


Msg -6 


Public 


N 


MsgPrint 


Print the instance 


Msg-7 


Public 


N 


MsgSend 


Send message to object 


Msg -8 


Public 


N 


MsgSendReturnlnt 


Send message to object, return int 


Msg -9 


Public 


N 


MsgSendReturnPtr 


Send message to object, return pointer 


Msg -10 


Public 


N 


MsgSetSuperOffsetAndMethod 


Override the method 


N/A 


Undoc 


N 



Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


MsgDelnit 


Deinit instance 


Msg -2 


N 


MsgGetMethod 


Return method 


Msg -4 


N 


MsgGetOffset 


Return the object offset 


Msg-3 


N 


MsgGetSelector 


Return selector 


Msg -5 


N 


Msglnit 


Initialize instanc 


Msg -6 


N 


MsgPrint 


Print the instance 


Msg-7 


N 


MsgSend 


Send message to object 


Msg -8 


N 


MsgSendReturnlnt 


Send message to object, return int 


Msg-9 


N 


MsgSendReturnPtr 


Send message to object, return pointer 


Msg -10 


N 


Private Functions 


None 








Undocumented Functions 






Function Name 


Description 


Page 


Macro 


MsgSetSuperOffsetAndMethod 


Override the method 


N/A 


N 
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Friend Functions 



None 









Listing Of Functions by Category 

Initialization Functions 
Function Name Description Page Scope Macro 



MsgOelnit 


Oeinit instance 


Msg -2 


Public 




N 


Msglnit 


Initialize instanc 


Msg-6 


Public 




N 



Query Functions 

Function Name Description Page Scope Macro 



MsgGetMethod 


Return method 


Msg -4 


Public 


N 


MsgGetOffset 


Return the object offset 


Msg -3 


Public 


N 


MsgGetSelector 


Return selector 


Msg-5 


Public 


N 



Debug Functions 

Function Name Description Page Scope Macro 



MsgPrint 


Print the instance 


Msg-7 


Public 


N 




Object Functions 








Function Name 


Description 


Page 


Scope Macro 


MsgSend 


Send message to object 


Msg -8 


Public 


N 


MsgSendReturnlnt 


Send message to object, return int 


Msg-9 


Public 


N 


MsgSendReturnPtr 


Send message to object, return pointer 


Msg -10 


Public 


N 
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Undocumented Functions 



Function Name 


Description 


Page 


Scope Macro 


MsgSetSuperOffsetAndMethod 


Override the method 


N/A 


Undoc 


N 


Listing Of Functions With Macros Available 


None 
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Class Description for Object 



Structure Name: 



Object 
Ob] 

Primitive Class. 



Abbreviation: 



Class Type: 



Introduction 

The Object class is the conduit by which a structure gains the object-oriented 
properties of inheritance and dynamic binding. Any class which desires these 
properties must include an instance of Object as the first structure member. 

A structure which includes Object can inherit properties and messages from 
other object-oriented classes. It can be inherited by other other object-oriented 
classes. Finally, it can send messages which can be received and implemented 
by subclasses (clients) or superclasses. 

A class uses Object to retrieve client pointers, send messages, and ask 
questions about the type of the object. 

Instances of object are never created directly. Classes which include Object in 
their definition should always create instances via ClsCreateObiect and destroy 
instances through ObjDestroy. A class need not initialize an Object (Objlnit) as 
this will occur automatically via ClsCreateObject. 

MetaClass, along with Class, Object, Message, MetaSuperClass, MetaMessage, 
and Block collectively define and implement the object-oriented properties of 
inheritance and dynamic binding (messaging) in C+O class libraries. 
Encapsulation, while supported by the above code, can be implemented by the 
programmer simply writing enough functions for a structure to obviate the 
need to access the structure members directly. These classes should be studied 
as a group to understand how C+O implements object-oriented C programs. 
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Description 

The function of the class Object is mainly to keep track of the instance of Class 
that is associated with this structure. The Class instance enables the Object 
instance to determine whether or not its part of a larger object and what 
messages it can respond to (and what method to call when a message is 
invoked). 

Glossary and Special Terms 

A subobject is what a subclass is to a class. It is the object instance which 
incorporates the object. 

A superobject is what a superclass is to a class. It is an object instance 
contained by an object. 

The root object is an object which has no subobject. Root objects are typically 
created by ClsCreateObject and destroyed by ObjDestroy. 

For other definitions, see the tutorial section. 

Class Implementation Object 

Superclasses 

The Object class is primitive and has no superclasses. 

Messages and Responses 

The Object class is primitive and has no messages. 

Class Variables 

The Object class has no class variables. 
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Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 



ObjDelnit 


Deinitialize instance 


Obj 


■2 


Public 


N 


ObjDestroy 


Deinitialize and deallocate object 


Obj 


•3 


Public 


N 


ObjGetCfient 


Return a client 


Obj 


•4 


Public 


N 


ObjGetCIientOrNull 


Return client if non-NULL 


Obj 


•6 


Public 


N 


ObjGetCIs 


Return class 


Obj- 


•8 


Public 


N 


ObjGetClsName 


Return class name 


Obj 


•9 


Public 


N 


Ohinptlmmpriiptpdipnt 

wUJVJGllllUIIGUKllC/Vsllvl H 


Rottirn immoHisto Hiont 
nciuiii iiiiiiicuiaic uticiii 






Pi i hi ir 
rUDIIC 


M 


ObjGetMethodAndOffset 


Return method and client offset 


Obj 


■11 


Public 


N 


ObjGetNthSuperObject 


Return nth superobject 


Obj 


•13 


Public 


N 


ObjGetRootClient 


Get root client 


Obj 


■14 


Public 


N 


ObjGetRootClientSize 


Get root object size 


Obj 


•15 


Public 


N 


ObjGetSize 


Get object size 


Obj- 


•16 


Public 


N 


ObjGetSubObjectOffset 


Return offset to immediate subobject 


Obj- 


•17 


Public 


N 


Objlnit 


Initialize object 


Obj- 


18 


Public 


N 


ObjlsRoot 


Return Treu if is root subobject 


Obj- 


19 


Public 


N 


ObjRespondsToSelector 


Does object understand message? 


Obj 


•20 


Public 


N 


ObjSendMessage 


Send message to object 


Obj- 


•21 


Public 


N 


ObjSendMessageRetumlnt 


Send message to object, return Int 


Obj- 


22 


Public 


N 


ObjSendMessageReturnPtr 


Send message to object, return pointer 


Obj- 


•23 


Public 


N 



Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


ObjDelnit 


Deinitialize instance 


Obj -2 


N 


ObjDestroy 


Deinitialize and deallocate object 


Obj -3 


N 


ObjGetCfient 


Return a client 


Obj -4 


N 


ObjGetCIientOrNull 


Return client if non-NULL 


Obj -6 


N 


ObjGetCIs 


Return class 


Obj -8 


N 


ObjGetClsName 


Return class name 


Obj -9 


N 


ObjGetlmmediateClient 


Return immediate client 


Obj -10 


N 


ObjGetMethodAndOffset 


Return method and client offset 


Obj - 11 


N 


ObjGetNthSuperObject 


Return nth superobject 


Obj -13 


N 


ObjGetRootClient 


Get root client 


Obj -14 


N 


ObjGetRootClientSize 


Get root object size 


Obj -15 


N 


ObjGetSize 


Get object size 


Obj - 16 


N 


ObjGetSubObjectOffset 


Return offset to immediate subobject 


Obj -17 


N 


Objlnit 


Initialize object 


Obj -18 


N 


ObjlsRoot 


Return Treu if is root subobject 


Obj -19 


N 
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Public Functions (cont) 



Function Name 


Description 


Page 


Macro 


ObjRespondsToSelector 


Does object understand message? 


Obj -20 


N 


ObjSendMessage 


Send message to object 


Obj -21 


N 


ObjSendMessageRetumlnt 


Send message to object, return Int 


Obj-22 


N 


ObjSendMessageRetumPtr 


Send message to object, return pointer 


Obj-23 


N 



Private Functions 



None 









Undocumented Functions 



None 



Friend Functions 



None 



Listing Of Functions by Category 

Initialization Functions 
Function Name Description Page Scope Macro 



ObjDelnit 


Deinitialize instance 


Obj-2 


Public 




N 


ObjDestroy 


Deinto'alize and deallocate object 


Obj -3 


Public 




N 


Objlnit 


Initialize object 


Obj - 18 


Public 




N 
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Client Functi ns 



Function Name Description Page Scope Macro 



ObjGetClient 


Return a client 


Obj-4 


Public 




N 


ObjGetClientOrNull 


Return client if non-NULL 


Obj-6 


Public 




N 


ObjGetlmmediateClient 


Return immediate client 


Obj-10 


Public 




N 


ObjGetNthSuperObject 


Return nth superobject 


Obj-13 


Public 




N 


ObjGetRootClient 


Get root client 


Obj-14 


Public 




N 


ObjGetSubObjectOffset 


Return offset to immediate subobject 


Obj-17 


Public 




N 



Query Functions 



Function Name Description Page Scope Macro 



ObjGetCIs 


Return class 


Obj-8 


Public 




N 


ObjGetClsName 


Return class name 


Obj - 9 


Public 




N 


ObjGetRootClientSize 


Get root object size 


Obj-15 


Public 




N 


ObjGetSize 


Get object size 


Obj -16 


Public 




N 


ObjlsRoot 


Return Treu if is root subobject 


Obj -19 


Public 




N 



Query Functions 



Function Name 


Description 


Page 


Scope Macro 


ObjGetMethodAndOffset 


Return method and client offset 


Obj -11 


Public 


N 


Messaging Functions 








Function Name 


Description 


Page 


Scope Macro 


ObjRespondsToSelector 


Does object understand message? 


Obj -20 


Public 


N 


ObjSendMessage 


Send message to object 


Obj -21 


Public 


N 


ObjSendMessageRetumlnt 


Send message to object, return Int 


Obj -22 


Public 


N 


ObjSendMessageRetumPtr 


Send message to object, return pointer 


Obj -23 


Public 


N 



Listing Of Functions With Macros Available 



None 
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Class Description tor String 



Structure Name: 



String 
Str 



Abbreviation: 



Class Type: 



Primitive. 



Description 

The String class is used to represent and manipulate Null terminated character 
arrays and are identical to "normal" C strings. 

Some functions have been provided in this class which are available as 
functions already from the C compiler manufacturer. We have provided these 
not to insult anyone but to provide a function which maps to our naming 
convention and is perhaps more descriptive. We recognize this class is 
somewhat thin and future updates will expand the functions in this class. 

Glossary and Special Terms 

None 



Class Implementation String 



Instance Variables 



The String class is implemented as a typedef Char String. 
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Superclasses 

The String class does not inherit from any other classes. 

Class Variables 

The String class has no class instance variables. 



Function Listing In Alphabetic Order 



Function Name 


Description 


Page 


Scope Macro 


StrBasicExtract 


Extract a string 


N/A 


Undoc 


N 


StrExtract 


Extract string as specified 


Str-2 


Public 


N 


StrFromDate 


Fill string with a date 


Str-4 


.Public 


N 


StrFromMediumlnt 


Integer to string 


Str-6 


Public 


N 


Strlnit 


Init string to zero 


Str-8 


Public 


Y 


StrReplaceSubStr 


Replace sub-string in string 


Str-9 


Public 


N 


StrSet 


Copy string to another 


Str-11 


Public 


Y 


StrSqueeze 


Removes any character from string 


Str-13 


Public 


N 


StrToDate 


Parse a date string for year, month, day 


Str-15 


Public 


N 


StrToLower 


Change case of string to lower 


Str-17 


Public 


Y 


StrToMediumlnt 


String to integer 


Str-19 


Public 


N 


StrTollpper 


Change case of string to upper 


Str-21 


Public 


Y 



Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


StrExtract 


Extract string as specified 


Str-2 


Y 


StrFromDate 


Fill string with a date 


Str-4 


Y 


StrFromMediumlnt 


Integer to string 


Str-6 


Y 


Strlnit 


Init string to zero 


Str-8 


Y 


StrReplaceSubStr 


Replace sub-string in string 


Str-9 


Y 


StrSet 


Copy string to another 


Str-11 


Y 


StrSqueeze 


Removes any character from string 


Str-13 


Y 


StrToDate 


Parse a date string for year, month, day 


Str-15 


Y 


StrToLower 


Change case of string to lower 


Str-17 


Y 


StrToMediumlnt 


String to integer 


Str-19 


Y 


StrToUpper 


Change case of string to upper 


Str-21 


Y 
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Private Functions 



None 








Function Name 


Undocumented Functions 

Description 


Page 


Macro 


StrBasicExtract 


Extract a string 


N/A 


Y 


Friend Functions 


None 









Listing Of Functions by Category 

Manipulation Functions 



Function Name 


Description 


Page 


Scope Macro 


StrBasicExtract 


Extract a string 


N/A 


Undoc 


N 


StrExtract 


Extract string as specified 


Str-2 


Public 


N 


StrRepiaceSubStr 


Replace sub-string in string 


Str-9 


Public 


N 


StrSet 


Copy string to another 


Str-11 


Public 


Y 


StrSqueeze 


Removes any character from string 


Str-13 


Public 


N 


StrToLower 


Change case of string to lower 


Str-17 


Public 


Y 



Conversion Functions 
Function Name Description Page Scope Macro 



StrFromDate 


Fill string with a date 


Sir • 


•4 


Public 


N 


StrFromMediumlnt 


Integer to string 


Str- 


6 


Public 


N 


StrToDate 


Parse a date string for year, month, day 


Str- 


15 


Public 


N 


StrToMediumlnt 


String to integer 


Str- 


19 


Public 


N 


StrTollpper 


Change case of string to upper 


Str • 


21 


Public 


Y 
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Initialization Functions 



Function Name 


Description 


Page 


Scope Macro 


Strinit 


Init string to zero 


Str-8 


Public 


Y 


Listing Of Functions With Macros Available 








Function Name 


Description 


Page 


Scope 




Strinit 


Init string to zero 


Str-8 


Public 




StrSet 


Copy string to another 


Sir- 11 


Public 




StrToLower 


Change case of string to lower 


Str-17 


Public 




StrToUpper 


Change case of string to upper 


Str-21 


Public 
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Class Description for Tree 



Structure Name: Tree 

Abbreviation: Tre 

Class Type: Inheritable class 

Introduction 

The Tree structure is organized so that items of information are related 
hierarchically by branches. This data structure is important for many 
applications such as outlining, bill of materials, parsing, and genetics. 

Description 

A tree is a finite set of one or more nodes such that: (i) there is a specially 
designated node called the root; (ii) the remaining nodes are partitioned into 
disjoint sets where each of these sets is a tree. This is a recursive definition 
and will be used in describing many of the functions throughout the reference 
section for the Tree class. 

Figure 1 shows a tree with 13 nodes. The root of the tree is node A. 




Figure 1 
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Glossary and Special Terms 

There are many terms which are used when referring to trees. The following are 
the definitions we ascribe to them. 

An instance of a Tree (or its subclass) is often called a node. It contains the 
branches to other trees. 

The number of subtrees of a tree is called its degree. In Figure 2 the degree of 
A is 3, of C is 1 and of F is zero. 

Trees of degree zero are called leaves. In Figure 2 K, L and M are some of the 
leaf nodes. 

Trees with degree greater than zero are called branches. In Figure 2 A, B, E, 
C, D, and H are some of the branches. 

The subtrees of a Tree X are referred to as the children of X. X is referred to as 
the parent Tree. In Figure 2 the children of D are H, I, J; the parent of D is A. 

A tree with no parent is called a root. A is the root in Figure 2. 

Children of the same parent are said to be siblings. In Figure 2 H, I and J are 
siblings. 

For a tree with children, there is a designated first child and a last child. A 
tree with one child has the same tree for the first child as its last child. 

A successor or next sibling of a tree is the immediate sibling which leads 
toward the last child of their common parent. A predecessor or previous 
sibling of a tree is the immediate sibling leading toward the first child of their 
common parent. 

The ancestors of a tree are all the trees along the path from the root to that 
tree. In Figure 2 the ancestors of M are A, D and H. 

The descendants of a tree are its children and their children and so on. In 
Figure 2 the descendants of B are E, K, L, and F. 

The siblings of a subtree tree X, are the uncles of the children of X. In Figure 2 
the trees B and C are uncles of H, I and J. 

The sequential predecessor/ successor of a tree X is found by taking (i) the 
first child if any; (ii) or the adjacent predecessor/ successor sibling if any; (ill) or 
the adjacent uncle. In this way, the whole tree is traversed once (in pre-order). 
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A range of trees is defined by a b ginning tree and an nding tree. Both trees 
must be siblings. The beginning tree must precede the ending tree. The range 
includes any and all elements between the beginning and ending tree. 

Examples of valid ranges in Figure 2: 

1) B through D is the subtrees B, C, and D. 2) H through H is the subtree H 
Examples of invalid ranges in in Figure 2: 

1) E through B. E and B are not siblings. 2) F through G. F and G are not 
siblings. 3) J through H. J does not precede H. 

By walking a tree, we mean we visit a subset of the nodes of the tree in a 
particular order. Visiting a node means to call a function, passing that node a 
pointer to the tree or one of its clients. 

There are many ways to walk a tree. An in-order walk of X is defined as 
performing an in-order walk of the children of X then visiting X. In Figure 2 an 
in-order walk of B would visit the nodes K, L, E, F and B in that order. 

A pre-order walk of X is defined as visiting X then performing a pre-order walk 
of the children of X. In Figure 2 a pre-order walk of B would visit the nodes E, 
F, K, and L in that order. 

The level of a tree is defined by initially letting the root be at level L, then its 
children are at level L+l and so on. Figure 2 shows the levels of the trees. 



Level 
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Class Implementation Tree 

Instance Variables 

The following is the data structure definition for a tree. 

struct Tree { Obj obj; 

Mediumlnt treCheck; 

Dll children; 

Lei siblings; } 

obj Gives Tree class object-oriented properties of inheritance and 

dynamic binding. 
treCheck Uniquely identifies Tree instances, 

children List of children, 

siblings ListElement in a list of siblings. 

Superclasses 

Type Name Description 

List Dll Children of tree 

ListElement Lei Siblings 

Messages and Responses 

Tree overrides the destroy message from its List superclass and its ListElement 
superclass. The implementation of the destroy message is handled by 
TreDestroy. Subclasses of Tree should override this message. 

Selector Method Description 

destroy TreDestroy Destroy the object 

Class Variables 

Typ e Name Description 

Mcl TreMcl Metaclass description for Tree. 

Mediumlnt TreDIIOffset Client offset of Tree from superclass Dll 

Mediumlnt TreLelOffset Client offset of Tree from superclass Lei 
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Function Listing In Alphabetic Order 



Function Name 


Description 


Page 


Scope Macro 


I re Asun 


Return node as fist 


Tre-2 


Private 


Y 


i reASLei 


Return node as list element 


Tre -3 


Private 


Y 


ireAsuDj 


Return node as object 


Tre -4 


Private 


Y 


i reuear 


Clear the tree 


Tre -5 


Public 


N 


ireuient 


Return client of node 


Tre-6 


Public 


Y 


TreClientFindCnfld 


Visit search function: children 


Tre -7 


Public 


N 


TreclientRrstChfld 


Return first child node as client 


Tre -9 


Public 


Y 


TreClientLastChild 


Return last child node as client 


Tre -11 


Public 


Y 


TreClientLastLeaf 


Return last leaf node as client 


Tre -13 


Public 


Y 


TreCiientNext 


Return next node as client 


Tre -15 


Public 


Y 


TreClientNextPreOrder 


Return next PreOrder client node 


Tre -17 


Public 


Y 


TreClientNexlUncle 


Return next uncle as client 


Tre-19 


Puhiie 


Y 

• 


TreClientParent 


Return parent node 


Tre - 21 


Public 


Y 


TreClientPrev 


Return prev client 


Tre - 23 


Public 


Y 


TreClientPrevPreOrder 


Return previous client PreOrderly 


Tre - 25 


Public 


Y 


I reoiientvisitDrancninorder 


Visit function: branch in-order 


Tre - 27 


Public 


N 


I reuiientvisitCriiiaren 


Visit function: all children 


Tre -29 


Public 


N 


rreCiientvisitcniidrenDwa 


Visit function: all children 


Tre -31 


Public 


N 


TreClientVisitDescBranchlnOrder 


Visit function: descendents 


Tre -33 


Public 


N 


1 reuient visituescinurder 


Visit function: descendents 


Tre -35 


Public 


N 


i reutentvisituescinurderDWd 


Visit function: descendents 


Tre -37 


Public 


N 


i reoiieni visituescLeaves 


visit function: descendents 


Tre -39 


Private 


N 


i reoiient visinjescrreuraer 


Visit function: descendents 


Tre -41 


Public 


N 


i reoiieni visuinuraer 


Visit function: in-order 


Tre -43 


Public 


N 


TroPliontX/ieitlnTW'HorRuuH 


visit function, in-order 


Tre - 45 


Public 


N 


1 rei/iienivisiiLedves 


Visit function: leaves 


Tre - 47 


Public 


N 


i reuiienivisiirarenis 


Visit function: nearest parents first 


Tre - 49 


Public 


N 


i reuiienivisiirT euruer 


Visit function: pre-order 


Tre - 51 


Public 


N 


i reuiieni visiinange 


Visit function: range 


Tre -53 


Public 


N 


i reuientvisitouccrreuraer 


Visit function: all successors 


Tre -55 


rUDIIC 


M 


TreCIientVisitSuccessors 


Visit function: successors 


Tre -57 


Public 


N 


TreCutChildren 


Cut children from tree 


Tre -59 


Public 


Y 


TreCutRange 


Cut node(s) from tree 


Tre -61 


Public 


Y 


TreDelnit 


Oeinitiatize Tree object 


Tre -63 


Public 


N 


TreDestroy 


Deinitialize Tree object and free space 


Tre -64 


Public 


N 


TreDestroyChildren 


Destroy any children of a tre 


Tre -65 


Public 


N 


TreFirstChild 


Return first child 


Tre -66 


Private 


Y 


TreHasChildren 


Does node have any children 


Tre-68 


Public 


Y 


TreHasSiblings 


Does node have any siblings 


Tre -69 


Public 


Y 


Trelnit 


Initialize tree object 


Tre -70 


Public 


N 


TrelsChild 


Does the node have a parent 


Tre -71 


Public 


Y 


TrelsDirectAncestor 


Is node a direct ancester 


Tre -72 


Public 


N 
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Function Listing In Alphabetic Order (cont) 



Function Name 


Description 


Page 


Scope Macro 


TrelsRoot 


Does the node have no parent 


Tre -73 


Di ihlir> 
rUDIIC 


v 

T 


TreUstChild 


Return last child 


Tre -74 


Private 


v 
Y 


TreLastLeaf 


Return last leaf 


Tre -76 


private 


M 

N 


TreNext 


Return next node 


Tre -78 


Private 


v 
Y 


TreNextPreOrder 


Return next node PreOrderiy 


Tre -80 


rnvaie 


IN 


TreNextUncle 


Return next uncle 


Tre -82 


rrivate 


M 

IN 


TreParent 


Return parent node 


Tre -84 


rnvate 


v 
Y 


TrePasteRangeAfterSibling 


Paste range of siblings 


Tre -86 


rUDIIC 


v 
Y 


TrePasteRangeBeforeSibling 


Paste range of siblings 


Tre -88 


PUOItC 


v 
Y 


TrePasteRangeFirstChild 


Paste children 


Tre -90 


rUDIIC 


Y 


TrePasteRangeLastChild 


Paste children 


Tre -92 


Public 


Y 


TrePrev 


Return previous node 


Tre -94 


Private 


Y 


TrePrevPreOrder 


Return previous node PreOrderiy 


Tre -96 


Private 


N 


TreSendDestroy 


Send message for tree destruction 


Tre -98 


Public 


M 

IN 


TreVisitBranchlnOrder 


Visit function: branch in-order 


Tre-99 


Private 


N 


TreVisitChildren 


Visit function: children 


Tre -101 


Private 


N 


Tre Vi sitChildren Bwd 


Visit function: children 


Tre - 103 


Private 


N 


Trie Vi siiDAficBranch InOrder 


X/ieif fiinrtion* rip vpnripnta 


Tre - 105 


Private 


N 


TreVisitDescInOrder 


Visit (unction: descendents 


Tre -107 


Private 


N 


TreVisitDesclnOrderBwd 


Visit function: descendents 


Tre -109 


Private 


N 


TreVisitDescPreOrder 


Visit function: descendents 


Tre- 111 


Private 


N 


TreVisitinOrder 


Visit function: in-order 


Tre-113 


Private 


N 


TreVisitlnOrderBwd 


Visit function: in-order 


Tre- 115 


Private 


N 


TreVisitLeaves 


Visit function: leaves 


Tre -117 


Private 


N 


TreVisitParents 


Visit function: nearest parents first 


Tre -119 


Private 


N 


TreVisitPreOrder 


Visit function: pre-drder 


Tre -121 


Private 


N 


TreVisitRange 


Visit function: range 


Tre -123 


Private 


N 


TreVisitSuccPreOrder 


Visit function: all successors 


Tre -125 


Private 


N 


TreVisitSuccessors 


Visit function: successors 


Tre -127 


Private 


N 
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Function Listing By Scope 

Public Functions 



Function Name 


VC9w l|l UWI 1 


rage 


Macro 


TreClear 

1 1 vVlvvU 


Ploar tho fmo 
V/leal u le Lice 


ire - d 


HI 

N 


TreClient 

1 1 v Wllwl U 


nciurn cuerii or nooe 


ire -o 


N 


TreCIientRndChilri 


vibJi occuvTi luncuon. cnUQicn 


ire - / 


N 


TreClientFirstChild 


nciurn nrsi cniia nooe as ciieni 


ire -9 


ft 1 
N 


TrfiHIipntl astflhilrl 


Dflhim loot /%tttf#4 ^linnt 

neium last cniia noae as client 


ire - 1 1 


N 


TrpClipntl ash" paf 


D Oil Ifn loot I Aof n/\ria op ^1 io n4 

neium iasi leai noae as client 


ire - 13 


N 


1 ICwIieiill^iCAl 


neium next noae as client 


Tre - 15 


N 


TrpCfipntNlpytPrpDnipr 

• I CvllCI III ^CAll 1 CUI UCl 


neium next rreurcer ctient noae 


Tre - 1 7 


ft 1 
N 


TnpniipntNpyti Jnrlp 

1 1 G\>1ICI IlIlCAlVJI »UlC 


neium next uncie as client 


Tre - 19 


N 


TreCIientParent 

• ivwHOHU CU will 


nciurn parent noce 


ire - 21 


til 

N 


TreClientPrev 

i iwwuwiiii IV* 


nclUlil pfev UllcTU 


i re - 23 


N 


TreClientPrevPreOrdpr 

UUvllblKI 1 VII IwVIUvl 


nciui ii previous oient ricAjrueny 


i re - 25 


N 


TrpCHpntVWtRranch InOrrfpr 


visit Tuncuon. Drancn in-oraer 


Tre - 27 


N 


TreClientVisitChfldrpn 


vibu luncuon. ail cniiuren 


T rrt Aft 

ire -29 


N 


TreCHenfVisitChildrpnRwri 

1 1 wvllwlllilollvl HlUlvl lUVfU 


vioii luucuon. an cniiuicn 


TrA 0*1 

ire - 31 


Kl 

N 


TreCIientVisitDescBranchlnOrder 


Visit fifnctinn* riocronriontc 

VloU lUliWUvll. UC9vCl lUCI 119 


lie - 


Kt 

N 


TreClientVisilDesclnOrder 


X/icit function* rfpcconHontc 

VI OH lullvUvll. UCOvCI HJCI Uo 


ire - 00 


IM 


TreClientVisitDesclnOrderBwd 


VI Oil lUlivUUIl. UCOvCl KJCI ltd 


1 re - o# 


Kl 

N 


TreCIientVisitDescPreOrder 


Visit fiinrtinn* riocoonriontc 
vi oil lunvtiyii. ucowCiiuciUo 


1 IC - *fl 


Kl 

IM 


TreCHentVisitlnOrder 

■ 1 WWIIvl H » 1 Willi l^/l Uvl 


vioti luiiuuon. in*viucr 


ire - 43 


N 


TreClientVisitlnOrderBwd 


Visit function* in-orripr 

viwH IUItwUyil< III vl VJCI 


Tro - 
lie - *KJ 


Kl 
IM 


TreClientVisitLeaves 


Visit function* Ipjivps 

wlvll IUII\#llwll« ICQVvO 


TfP - 61 
lie *♦/ 


Kl 
IM 


TreClientVisitPafents 


Visit function* nppfpst narontQ firct 

vioii luiivumi. ileal col pateillo III ol 


Tro - AO 
1 re - «f v 


Kl 
IM 


TreClientVisitPfBOrder 


Visit function* nrp-nrdpr 

lUllwUvll. pi C vlUCl 


Tro . ^1 
1 1 c - 0 I 


Kl 
IM 


TreCIientVisitRange 


Visit function* ran/IP 

tioiv iui iwuvi i. icu »yc 


Tro - *tt 
lie - 00 


Kl 
IM 


TreClientVisitSuccPreOrder 


Visit function: all successors 


Tre -55 


N 


TreClientVisitSuccessors 


Visit function: successors 


Tre -57 


N 


TreCutChildren 


Cut children from tree 


Tre -59 


N 


TreCutRange 


Cut node(s) from tree 


Tre -61 


N 


TreDelnit 


Deinitialize free object 


Tre -63 


N 


TreDesiroy 


Oeinitialize Tree object and free space 


Tre -64 


N 


TreDestroyChildren 


Destroy any children of a tre 


Tre -65 


N 


TreHasChildren 


Does node have any children 


Tre -68 


N 


TreHasSiblings 


Does node have any siblings 


Tre -69 


N 


Trelnit 


Initialize tree object 


Tre • 70 


N 


TrelsChild 


Does the node have a parent 


Tre -71 


N 


TrelsDireclAncestor 


Is node a direct ancester 


Tre-72 


N 


TrelsRoot 


Does the node have no parent 


Tre -73 


N 


TrePasteRangeAfterSibling 


Paste range of siblings 


Tre -86 


N 
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Public Functions (cont) 



Function Name 


Description 


Page 


Macro 


i ferasteHangeDeioreoiDnng 


Paste range of siblings 


T#* OA 

Tre - 88 


N 


i rerasienangerirsiuniia 


Paste children 


ire -90 


N 


TrePasteRangeLastCruld 


Paste children 


Tre -92 


N 


TreSendDeslroy 


Send message for tree destruction 


Tre - 98 


N 




aa 5 • • am& aa* ETa a am A a am wa> am 

private Functions 






Function Name 


Description 


Page 


Macro 


TreAsDll 


Return node as list 


Tre -2 


N 


ireAsLei 


Return node as list element 


Tre -3 


N 


TreAsOpi 


Return node as object 


Tre -4 


N 


TreCIientVisilDescLeaves 


Visit function: descendents 


Tre -39 


N 


TreRrstChild 


Return first child 


Tre-66 


N 


TreLastChild 


Return last child 


Tre -74 


N 


TreLastLeaf 


Return last leaf 


Tre -76 


N 


TreNext 


Return next node 


Tre -78 


N 


TreNextPreOrder 


Return next node PreOrdeiiy 


Tre -80 


N 


TreNextuncie 


Return next uncle 


Tre - 82 


N 


TreParent 


Return parent node 


Tre -84 


N 


TrePrev 


Return previous node 


Tre - 94 


N 


i rerrevrreuroer 


Return previous node PreOrderly 


Tre -96 


N 


ire visitDrancn inuraer 


Visit function: branch in-order 


Tre -99 


N 


i re visuuniiaren 


visit function: children 


Tre • 101 


N 


TreVisituniidrenBwd 


Visit function: children 


Tre-103 


N 


TreVisitDescBranchlnOrder 


Visit function: descendents 


Tre -105 


N 


TreVisitDesclnOrder 


Visit function: descendents 


Tre -107 


N 


TreVisitDesclnOrderBwd 


Visit function: descendents 


Tre -109 


N 


TreVisitDescPreOrder 


Visit function: descendents 


Tre- 111 


N 


TreVisitlnOrder 


Visit function: in-order 


Tre -113 


N 


TreVisitlnOrderBwd 


Visit function: in-order 


Tre-115 


N 


TreVisitLeaves 


Visit function: leaves 


Tre -117 


N 


TreVisitParents 


Visit function: nearest parents first 


Tre -119 


N 


TreVisitPreOrder 


Visit function: pre-order 


Tre - 121 


N 


TreVisitRange 


Visit function: range 


Tre -123 


N 


TreVisitSuccPreOrder 


Visit function: all successors 


Tre -125 


N 


TreVisitSuceessors 


Visit function: successors 


Tre -127 


N 
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Undocumented Functions 



None 








Friend Functions 


None 









Listing Of Functions by Category 

Superclass Functions 



Function Name 


Description 


Page 


Scope Macro 


TreAsDII 


Return node as list 


Tre-2 


Private 


Y 


TreAsLel 


Return node as list element 


Tre-3 


Private 


Y 


TreAsObj 


Return node as object 


Tre-4 


Private 


Y 




Edit Functions 








Function Name 


Description 


Page 


Scope Macro 


TreClear 


Clear the tree 


Tre-5 


Public 


N 


TreCutChildren 


Cut children from tree 


Tre-59 


Public 


Y 


TreCutRange 


Cutnode(s) from tree 


Tre-61 


Public 


Y 


TrePasteRangeAfterSibling 


Paste range of siblings 


Tre-86 


Public 


Y 


TrePasteRangeBeforeSibling 


Paste range of siblings 


Tre-88 


Public 


Y 


TrePasteRangeFirstChild 


Paste children 


Tre-90 | 


Public 


Y 


TrePasteRangeLastChild 


Paste children 


Tre-92 


Public 


Y 
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Query Functions 



Function Name 


Description 


Page 


Scope Macro 


TreClient 


Return client of node 


Tre-6 


Pi ihlir 

ruuiic 


v 

T 


TreClientFindChild 


Visit search function: children 


Tre-7 


Public 


N 


TreCltentRrstChnd 


Return first child node as client 


Tre-9 


Public 


v 
Y 


TreCKentLastChild 


Return last child node as client 


Tre-11 


Public 


v 
Y 


TreClientLastLeaf 


Return last leaf node as client 


Tre-13 


D* ikli a 

rUDIIC 


Y 


TreClientNext 


Return next node as client 


Tre-15 


rUDIIC 


Y 


TreClientNextPreOrder 


Return next PreOrder client node 


Tre-17 


rUOIIC 


Y 


TreClientNextUncle 


Return next uncle as client 


Tre-19 


rUDIIC 


Y 


TreClientParent 


Return parent node 


Tre-21 


rUDIIC 


Y 


TreClientPrev 


Return prev client 


Tre-23 


rUDIIC 


Y 


TreCIientPrevPreOrder 


Return previous client PreOrderly 


Tre-25 


rUDIIC 


Y 


TreRrstChiid 


Return first child 


Tre-66 


Private 


Y 


TreHasChildren 


Does node have any children 


Tre-68 


Public 


Y 


TreHasSiblings 


Does node have any siblings 


Tre-69 


Public 


Y 


TrelsChild 


Does the node have a parent 


Tre-71 


Public 


Y 


TrelsDirectAncestor 


Is node a direct ancester 


Tre-72 


Pubfic 


N 


TrelsRoot 


Does the node have no parent 


Tre-73 


Public 


Y 


TreLastChild 


Return last child 


Tre-74 


Private 


Y 


TreLastLeaf 


Return last leaf 


Tre-76 


Private 


N 


TreNext 


Return next node 


Tre-78 


Private 


Y 


TreNextPreOrder 


Return next node PreOrderty 


Tre-80 


Private 


N 


TreNextUncle 


Return next uncle 


Tre-82 


Private 


N 


TreParent 


Return parent node 


Tre-84 


Private 


Y 


TrePrev 


Return previous node 


Tre-94 


Private 


Y 


TrePrevPreOrder 


Return previous node PreOrderly 


Tre-96 


Private 


N 
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Visit Functions 



Function Name Description Page Scope Macro 



TreClientVisitBranchlnOrder 


Visit function: branch in-order 


Tre 


-27 


Public 


N 


TreClientVisitChildren 


Visit function: all children 


Tre 


-29 


Public 


N 


TreClientVisitChildfenBwd 


Visit function: all children 


Tre 


-31 


Public 


N 


TreClientVisitDescBranchlnOrder 


Visit function: descendents 


Tre 


•33 


Public 


N 


TreClientVisitDesclnOrder 


Visit function: descendents 


Tre 


■35 


Public 


N 


TreClientVisitDesclnOrderBwd 


Visit function: descendents 


Tre 


-37 


Public 


N 


TreClientVisitDescLeaves 


Visit function: descendents 


Tre 


•39 


Private 


N 


TreCIientVisitDescPreOrder 


Visit function: descendents 


Tre 


-41 


Public 


N 


TreClientVisitlnOrder 


Visit function: in-order 


Tre 


•43 


Public 


N 


TreClientVisitlnOrderBvvd 


Visit function: in-order 


Tre 


■45 


Public 


N 


TreClientVisileaves 


Visit function: leaves 


Tre 


•47 


Public 


N 


TreClientVisitParents 


Visit function: nearest parents first 


Tre 


•49 


Public 


N 


TreClientVisitPreOrder 


Visit function: pre-order 


Tre 


■51 


Public 


N 


TreClientVisitRange 


Visit function: range 


Tre 


•53 


Public 


N 


TreClientVisitSuccPreOrder 


Visit function: all successors 


Tre 


•55 


Public 


N 


TreClientVisitSuccessors 


Visit function: successors 


Tre 


•57 


Public 


N 


TreVisitBranchlnOfder 


Visit function: branch in-order 


Tre- 


-99 


Private 


N 


TreVisitChildren 


Visit function: children 


Tre 


•101 


Private 


N 


TreVisitChildrenBwd 


Visit function: children 


Tre- 


•103 


Private 


N 


TreVisitDescBranchlnOrder 


Visit function: descendents 


Tre- 


105 


Private 


N 


TreVisitDesclnOrder 


Visit function: descendents 


Tre- 


107 


Private 


N 


TreVisitDesclnOrderBwd 


Visit function: descendents 


Tre- 


109 


Private 


N 


TreVisitDescPreOrder 


Visit function: descendents 


Tre- 


111 


Private 


N 


TreVisitlnOrder 


Visit function: in-order 


Tre- 


113 


Private 


N 


TreVisitlnOrderBwd 


Visit function: in-order 


Tre- 


115 


Private 


N 


TreVisitLeaves 


Visit function: leaves 


Tre- 


117 


Private 


N 


TreVisitParents 


Visit function: nearest parents first 


Tre- 


119 


Private 


N 


TreVisitPreOrder 


Visit function: pre-order 


Tre- 


121 


Private 


N 


TreVisitRange 


Visit function: range 


Tre- 


123 


Private 


N 


TreVisitSuccPreOrder 


Visit function: all successors 


Tre- 


125 


Private 


N 


TreVisitSuccessors 


Visit function: successors 


Tre- 


127 


Private 


N 



initialization Functions 



Function Name 


Description 


Page 


Scope Macro 


TreDelnit 


Deinitialize Tree object 


Tre-63 


Public 


N 


TreDestroy 


Deinitialize Tree object and free space 


Tre-64 


Public 


N 


TreDestroyChildren 


Destroy any children of a tre 


Tre-65 


Public 


N 


Trelnit 


Initialize tree object 


Tre-70 


Public 


N 


TreSendDestroy 


Send message for tree destruction 


Tre -98 


Public 


N 
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Listing Of Functions With Macros Available 



Function Name Description Page Scope 



TreAsDII 


Return node as list 


Tre- 


• 2 


Private 


TreAsLel 


Return node as Gist element 


Tre- 


•3 


Private 


TreAsObj 


Return node as object 


Tre- 


-4 


Private 


TreClient 


Return client of node 


Tre- 


■6 


Public 


TreClientRrstChild 


Return first child node as client 


Tre 


•9 


Public 


TreClientLastChild 


Return last child node as client 


Tre 


•11 


Public 


TreCfientLastLeaf 


Return last leaf node as client 


Tfe 


■13 


Pubfic 


TreClientNext 


Return next node as client 


Tre 


■15 


Public 


TreGlientNextPreOrder 


Return next PreOrder client node 


Tre- 


•17 


Public 


TreClientNextUncle 


Return next uncle as client 


Tre 


■19 


Public 


TreClientParent 


Return parent node 


Tre- 


•21 


Public 


TreClientPrev 


Return prev client 


Tre- 


•23 


Public 


TreClientPrevPreOrder 


Return previous client PreOrderly 


Tre- 


•25 


Public 


TreCutChildren 


Cut children from tree 


Tre 


■59 


Public 


TreCutRange 


Cut node(s) from tree 


Tre< 


■61 


Public 


TreRrstChild 


Return first child 


Tre- 


•66 


Private 


TreHasChildren 


Does node have any children 


Tre 


■68 


Public 


TreHasSiblings 


Does node have any siblings 


Tre 


•69 


Public 


TrelsChild 


Does the node have a parent 


Tre 


•71 


Public 


TrelsRoot 


Does the node have no parent 


Tre 


•73 


Public 


TreLastChild 


Return last child 


Tre 


•74 


Private 


TreNext 


Return next node 


Tre 


•78 


Private 


TreParent 


Return parent node 


Tre 


•84 


Private 


TrePasteRangeAfterSibling 


Paste range of siblings 


Tre 


•86 


PubBc 


TrePasteRangeBefbreSibiing 


Paste range of siblings 


Tre 


-88 


Public 


TrePasteRangeRrstChild 


Paste children 


Tre 


■90 


Public 


TrePasteRangeLastChild 


Paste children 


Tre 


-92 


Public 


TrePrev 


Return previous node 


Tre 


•94 


Private 
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Class Description for Task 



Structure Name: 



Task 



Abbreviation: 



Tsk 



Class Type: 



Primitive Class 



Introduction 

The Task class models the program being executed. Currently its major usage 
is to handle exceptions that may arise during program execution. A task may 
set up any number of exception handlers for intercepting exceptions that are 
raised by a program. C+O class libraries include a debug library which checks 
parameter input to functions scrupulously, generating exceptions if the 
parameter is invalid. 

Description 

The first call in a C+O program should be a call to Tsklnit or TskDefaultlnit. 
Most, if not all, programs should initialize the pre-defined global TskMain. 
Once a task has been initialized, a call should be made to TskOnException. 
This sets up an exception handler for the program which will catch many 
program logic errors, especially calls to C+O. 

Glossary and Special Terms 

No special glossary exists for this class. 
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Class Implementation Task 



Instance Variables 

The following Is the data structure definition for Task. 



struct Task { 



tskCheck 

argc 

*argv 

exhStack 

current 

fileName 

lineNo 

condition 

detExcFilter 



Superclasses 



None 



Mediumlnt 
Mediumlnt 
PSTR 
Dpa 

Mediumlnt 

PSTR 

Mediumlnt 

Mediumlnt 

ExceptionType 

ExcFilter 



tskCheck; 

argc; 

*argv; 

exhStack; 

current; 

fileName; 

lineNo; 

condition; 

type; 
defExcFilter; } 



Uniquely identifies Task instances. 

Argc from mainO. 

Argv from mainO. 

Stack of exception handlers. 

Active exception handler index. 

File which invoked exception. 

Line number in file which invoked exception. 

Condition value at time of exception. 

Type of exception. 

Filter for exception handler. 



Messages and Responses 

None 

Class Variables 



Type 

Task 



Name 

TskMain 



Description 

The default task for the program 
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Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 



TskBasicAssert 


Foundation function 


N/A 


Undoc 


N 


TskCondition 


Raise exception conditionally 


Tsk-2 


Public 


N 


TskDelnit 


Deinitialize instance 


Tsk-4 


Public 


N 


TskDefaultlnit 


Initialize instance with defaults 


Tsk-5 


Public 


N 


TskExit 


Exit program with code 


Tsk-6 


Public 


N 


TskExitWithMsg 


Exit program and print message 


Tsk-7 


Public 


N 


TskGetArgc 


Get mainQ argument count 


Tsk-8 


Public 


N 


TskGetArgv 


Get mainQ argument vector 


Tsk-9 


Public 


N 


TskGetExceptionCondition 


Return exception condition 


Tsk-10 


Public 


N 


TskGetExceptionFileName 


Return filename of exception 


Tsk-11 


Public 


N 


TskGeExceptionLineNo 


Return exception line number 


Tsk-12 


Public 


N 


TskGetExceptionType 


Return exception type 


Tsk-13 


Public 


N 


Tsklnit 


Initialize instance 


Tsk-15 


Public 


N 


Tsklslnitiafized 


Is the Task initialized 


N/A 


Undoc 


N 


TskLogCond 


Raise exception conditionally 


Tsk-17 


Public 


N 


TskMainLogCond 


Raise exception conditionally 


Tsk-19 


Public 


N 


TskMainPreCond 


Raise exception conditionally 


Tsk-21 


Public 


N 


TskMainPtrCond 


Raise exception conditionally 


Tsk-23 


Public 


N 


TskMainRaiseException 


Raise exception unconditionally 


Tsk-25 


Public 


N 


TskNormalExit 


Exit task normally 


Tsk-27 


Public 


N 


TskOnException j 


Establish exception handler 


Tsk-28 


Public 


N 


TskPopExceptionHandler 


Pop exception handler 


Tsk-30 


Public 


N 


TskPreCond 


Raise exception conditionally 


Tsk-32 


Public 


N 


TskPrintException 


Print description of exception 


Tsk-34 


Public 


N 


TskPropagateException 


Pass last exception 


Tsk-36 


Public 


N 


TskPlrCond 


Raise exception conditionally 


Tsk-38 


Public 


N 


TskPushExh 


Push the exception 


N/A 


Undoc 


N 


TskRaiseException 


Raise exception unconditionally 


Tsk-40 


Public 


N 
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Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


TskCondition 


Raise exception conditionally 


Tsk-2 


N 


TskDelnit 


Deinitialize instance 


Tsk-4 


N 


TskDefaultlnit 


Initialize instance with defaults 


Tsk-5 


N 


TskExit 


Exit program with code 


Tsk-6 


N 


TskExitWilhMsg 


Exit program and print message 


Tsk-7 


N 


TskGetArgc 


Get main() argument count 


Tsk-8 


N 


TskGetArgv 


Get main() argument vector 


Tsk-9 


N 


TskGetExceptionCondition 


Return exception condition 


Tsk-10 


N 


TskGetExceptionRleName 


Return filename of exception 


Tsk-11 


N 


TskGetExceptionlineNo 


Return exception line number 


Tsk-12 


N 


TskGetExceptionType 


Return exception type 


Tsk-13 


N 


Tsklnit 


Initiaiizp irrefancp 


1 Oft 1«J 


N 


TskLogGond 


Raise exception conditionally 


Tsk-17 


N 


TskMainLogCond 


Raise exception conditionally 


Tsk-19 


N 


TskMainPreCond 


Raise exception conditionally 


Tsk-21 


N 


TskMainPtrCond 


Raise exception conditionally 


Tsk-23 


N 


TskMainRaiseException 


Raise exception unconditionally 


Tsk-25 


N 


TskNormalExit 


Exit task normally 


Tsk-27 


N 


TskOnException 


Establish exception handler 


Tsk-28 


N 


TskPopExceptionHandler 


Pop exception handler 


Tsk-30 


N 


TskPreCond 


Raise exception conditionally 


Tsk-32 


N 


TskPrintException 


Print description of exception 


Tsk-34 


N 


TskPropagafeException 


Pass last exception 


Tsk-36 


N 


TskPtrCond 


Raise exception conditionally 


Tsk-38 


N 


TskRaiseException 


Raise exception unconditionally 


Tsk-40 


N 


Private Functions 


None 








Undocumented Functions 






Function Name 


Description 


Page 


Macro 


TskBasicAssert 


Foundation function 


N/A 


N 


Tsklslnitialized 


Is the TasAc initialized 


N/A 


N 


TskPushExh 


Push the exception 


N/A 


N 
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Task 



Friend Functions 



None 









Listing Of Functions by Category 

Undocumented Functions 
Function Name Description Page Scope Macro 



TskBasicAssert 


Foundation function 


N/A - 


Undoc 


N ! 


Tsklslnitialized 


Is the Task initialized 


N/A 


Undoc 


N 


TskPushExh 


Push the exception 


N/A 


Undoc 


N 



Exception Functions 



Function Name 


Description 


Page 


Scope Macro 


TskCondition 


Raise exception conditionally 


Tsk-2 


Public 


N 


TskLogCond 


Raise exception conditionally 


Tsk-17 


Public 


N 


TskMainLogCond 


Raise exception conditionally 


Tsk-19 


Public 


N 


TskMainPreCond 


Raise exception conditionally 


Tsk-21 


Public 


N 


TskMainPtrCond 


Raise exception conditionally 


Tsk-23 


Public 


N 


TskMainRaiseException 


Raise exception unconditionally 


Tsk-25 


Public 


N 


TskOnException 


Establish exception handler 


Tsk-28 


Public 


N 


TskPopExceptionHandler 


Pop exception handler 


Tsk-30 


Public 


N 


TskPreCond 


Raise exception conditionally 


Tsk-32 


Public 


N 


TskPrintException 


Print description of exception 


Tsk-34 


Public 


N 


TskPropagateException 


Pass last exception 


Tsk-36 


Public 


N 


TskPtrCond 


Raise exception conditionally 


Tsk-38 


Public 


N 


TskRaiseException 


Raise exception unconditionally 


Tsk-40 


Public 


N 



Initialization Functions 



Function Name Description Page Scope Macro 



TskDelnit 


Deinitialize instance 


Tsk-4 


Public 




N 


TskOefaultlnit 


Initialize instance with defaults 


Tsk-5 


Public 




N 


Tsklnit 


Initialize instance 


Tsk-15 


Public 




N 
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Task 



Exit Functions 



Function Name Description Page Scope Macro 



TskExit 


Exit program with code 


Tsk-6 


Public 




N 


TskExitWithMsg 


Exit program and print message 


Tsk-7 


Public 




N 


TskNormalExit 


Exit task normally 


Tsk-27 


Public 




N 



Query Functions 



Function Name 


Description 


Page 


Scope Macro 


TskGetArgc 
TskGetAfgv 

TskGetExceptionCondition 
TskGetExceptionFileName 
TskGetExceptionUneNo 
TskGetExceptionType 


Get mainQ argument count 
Get mainQ argument vector 
Return exception condition 
Return filename of exception 
Return exception line number 
Return exception type 


Tsk-8 

Tsk-9 

Tsk-10 

Tsk-11 

Tsk-12 

Tsk-13 


Public 
Public 
Public 
Public 
Public 
Public 


N 
N 
N 
N 
N 
N 


Listing Of Functions With 


Macros Available 



None 
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Class Description for Vertex 



Structure Name: Vertex 

Abbreviation: Vtx 

Class Type: Inheritable class 



introduction 

A Vertex must be used in combination with Graph and Edge to be of any value. 
A Vertex can model among other things, activities in a critical path network, 
cities connected by highways, cells in a spreadsheet, etc. 

The Vertex class has two Jriend classes Edge and Graph. The documentation for 
the Vertex class should therefore be read in conjunction with the classes Edge 
and Graph. 

Description 

A vertex can have incoming edges and outgoing edges. In Figure 1 below the 
vertex A has an incoming edge x, and an outgoing edge y. 



Glossary and Special Terms 

The successor vertices of a Vertex A are the vertices at the head of the 
outgoing edges of A The predecessor vertices of A are the vertices at the tail 
end of the incoming edges of A. See Figure 1. 



Incoming Edge 




Outgoing Edge 
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Vertex 



Class Implementation Vertex 



Instance Variables 

The following is the data structure definition for a vertex in a directed graph. 



struct Vertex { 



Obj 

Medium I nt 

Lei 

Dll 

Dll 



object; 
vtxCheck; 
graph; 
inList; 
out List;}; 



obj 

vtxCheck 
graph 
inList 
outList 

Superclasses 
Type 

ListElement 

List 

List 



Gives Vertex class object-oriented properties of inheritance 

and dynamic binding. 

Uniquely identifies Vertex instances. 

List element in a graph. 

List of incoming edges. 

List of outgoing edges. 



Name 

GrfLel 

InDII 

OutDII 



Description 

Graph membership 
Listoi incoming edges 
List of outgoing edges 



Messages and Responses 

Vertex overrides the destroy message from both of its List superclasses and its 
ListElement superclass. The implementation of the destroy message is handled 
by VtxDestroy. The subclass of Vertex should override this method. 

Selector Method Description 

destroy VtxDestroy Destroy the object 
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Vertex 



Class Variables 

Type Name 



Mcl 

Mediumlnt 
Mediumlnt 
Mediumlnt 



VtxMcl 

VtxInDIIOffset 

VtxOutDIIOffset 

VtxGrfLelOffset 



Description 

Metaciass decription for Vertex. 
Client offset of Vertex from superclass 
InDII. 

Client offset of Vertex from superclass 
OutDII. 

Client offset of Vertex from superclass 
GrfLel. 



Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 



VtxAsGrfLel 


Return list element in graph 


Vtx-2 


Friend 


Y 


VtxAslnDII 


Return vertex as list of incoming edges 


Vtx-3 


Friend 


N 


VtxAsObj 


Return edge as object 


Vtx-4 


Private 


N 


VtxAsOutDII 


Return vertex as list of outgoing edges 


Vtx-5 


Friend 


N 


VtxClear 


Clear vertex 


Vtx-6 


Public 


N 


VtxConnectToGrf 


Connect vertex to graph 


Vtx-7 


Public 


N 


VtxCountln 


Count incoming edges 


Vtx-9 


Public 


Y 


VtxCountOut 


Count outgoing edges 


Vtx-11 


Public 


Y 


VtxDelnit 


Deinitialize the Vertex object 


Vtx-13 


Public 


N 


VtxDestroy 


Deinib'alize Vertex object and free space 


Vtx-14 


Public 


N 


VIxDisconnectFromGrf 


Disconnect vertex from graph 


Vtx-15 


Public 


Y 


VtxFindOutEdg 


Visit search function: outgoing edges 


Vtx-17 


Private 


N 


VtxFindOutEdgClient 


Visit search function: outgoing edges 


Vtx-19 


Public 


N 


VtxGetClient 


Return client of vertex 


Vtx-21 


Public 


Y 


VtxGetFirstln 


Return first incoming edge 


Vtx-22 


Public 


Y 


VtxGetRrstOut 


Return first outgoing edge 


Vtx-23 


Public 


Y 


VtxGetGrf 


Return graph 


Vtx-24 


Friend . 


Y 


VtxInGrt 


Is vertex in graph 


Vtx-26 


Public 


Y 


Vtxlnit 


Initialize the Vertex object 


Vtx-25 


Public 


N 


VtxSendDestroy 


Send message for vertex destruction 


Vtx-27 


Public 


N 


VtxStackSetup 


Set up values for topsort 


Vtx-28 


Friend 


Y 


VtxVisitEdge 


Visit function: each edge 


Vtx-29 


Friend 


N 


VtxVisitEdgeClient 


Visit function: each edge 


Vtx-31 


Public 


N 


VtxVisitlnEdge 


Visit function: incoming edge 


Vtx-33 


Friend 


N 


VtxVisitlnEdgeClient 


Visit function: incoming edge 


Vtx-35 


Public 


N 


VtxVisitOutEdge 


Visit function: outgoing edge 


Vtx-37 \ 


Friend 


N 


VtxVisitOutEdgeClient 


Visit function: outgoing edge 


Vtx-39 


Public 


N 
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Vertex 



Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


vtxClear 


Clear vertex 


Vtx-6 


N 


VtxConnectToGrf 


Conned vertex to graph 


Vtx-7 


N 


vtxcountin 


Count incoming edges 


VtX-9 


N 


VtxCountOut 


Count outgoing edges 


Vtx-11 


N 


VtxDelnit 


Deinitialize the Vertex object 


VtX-13 


N 


VtxDestroy 


Deinitialize Vertex object and free space 


Vtx-14 


N 


VtxDisconnectFromGrf 


Disconnect vertex from graph 


Vtx-15 


N 


VtxRndOutEdgQient 


Visit search function: outgoing edges 


Vtx-19 


N 


VtxGetClient 


Return client of vertex 


Vbc-21 


N 


VtxGetFirstln 


Return first incoming edge 


Vlx-22 


N 


VtxGetFirstOut 


Return first outgoing edge 


Vlx-23 


N 


VtxInGrf 


Is vertex in graph 


Vtx-26 


N 


Vtxlnit 


Initialize the Vertex object 


Vtx-25 


N 


VtxSendOestroy 


Send message for vertex destruction 


Vtx-27 


N 


VtxVisitEdgeaient 


Visit function: each edge 


Vtx-31 


N 


VtxVisitlnEdgeClient 


Visit function: incoming edge 


Vtx-35 


N 


VixVisitOutEdgeClient 


Visit function: outgoing edge 


Vtx-39 


N 




Private Functions 






Function Name 


Description 


Page 


Macro 


VtxAsObj 


Return edge as object 


Vtx-4 


N 


VlxRndOutEdg 


Visit search function: outgoing edges 


Vtx-17 


N 



Undocumented Functions 



None 
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Vertex 



Friend Functions 



Function Name 


Description 


Page 


Macro 


VtxAsGrfLel 


Return list element in graph 


Vtx-2 


N 


VtxAslnDU 


Return vertex as list of incoming edges 


Vtx-3 


N 


VtxAsOutDII 


Return vertex as Gst of outgoing edges 


Vtx-5 


N 


VtxGetGrf 


Return graph 


Vtx-24 


N 


VtxStackSetup 


Set up values for topscrt 


Vtx-28 


N 


VtxVisitEdge 


Visit function: each edge 


Vtx-29 


N 


VtxVisitlnEdge 


Visit function: incoming edge 


Vtx-33 


N 


VtxVisitOutEdge 


Visit function: outgoing edge 


Vtx-37 


N 



Listing Of Functions by Category 

Superclass Functions 
Function Name Description Page Scope Macro 



VtxAsGrfLel 


Return list element in graph 


Vtx-2 


Friend 


Y 


VtxAslnDU 


Return vertex as Gst of incoming edges 


Vtx-3 


Friend 


N 


VfxAsObj 


Return edge as object 


Vtx-4 


Private 


N 


VtxAsOutDII 


Return vertex as Gst of outgoing edges 


Vtx-5 


Friend 


N 




Edit Functions 








Function Name 


Description 


Page 


Scope Macro 


VtxClear 


Clear vertex 


Vtx-6 


Public 


N 


VbcConnectToGrf 


Connect vertex to graph 


Vtx-7 


Public 


N 


VtxDisconnectFromGrf 


Disconnect vertex from graph 


Vtx-15 


Public 


Y 
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Vertex 



Query Functi ns 



Function Name 


Description 


Page 


Scope Macro 


VtxCountln 


Count incoming edges 


Vtx-9 


Public 


Y 


VtxCountOul 


Count outgoing edges 


Vtx- 11 


Public 


Y 


VtxRndOutEdg 


Visit search function: outgoing edges 


Vtx-17 


Private 


N 


VtxRndOutEdgClient 


Visit search function: outgoing edges 


Vtx-19 


Public 


N 


VtxGetClient 


Return client of vertex 


Vtx-21 


Public 


Y 


VlxGetRrstln 


Return first incoming edge 


Vtx-22 


Public 


Y 


VlxGetRrstOut 


Return first outgoing edge 


Vtx-23 


Public 


Y 


VtxGetGrf 


Return graph 


Vtx-24 


Friend 


Y 


VtxInGrt 


Is vertex in graph 


Vtx-26 


Public 


Y. 


VtxStackSetup 


Set up values for topsort 


Vtx-28 


Friend 


Y 



Initialization Functions 
Function Name Description Page Scope Macro 



VtxDelnit ' 


Deinitialize the Vertex object 


Vtx 


-13 


Public 


N 


VtxDestroy 


DeiniSalize Vertex object and free space 


Vlx 


•14 


Public 


N 


Vtxlnit 


Initialize the Vertex object 


Vtx 


-25 


Public 


N 


VtxSendOestroy 


Send message for vertex destruction 


Vtx 


-27 


Public 


N 



Visit Functions 

Function Name Description Page Scope Macro 



VtxVisitEdge 


Visit function: each edge 


Vtx 


■29 


Friend 


N 


VtxVisitEdgeClient 


Visit function: each edge 


Vtx 


•31 


Public 


N 


VtxVisitlnEdge 


Visit function: incoming edge 


Vtx 


•33 


Friend 


N 


VtxVisitlnEdgeClient 


Visit function: incoming edge 


Vtx 


•35 


Public 


N 


VtxVisitOutEdge 


Visit function: outgoing edge 


Vtx 


•37 


Friend 


N 


VtxVisitOutEdgeClient 


Visit function: outgoing edge 


Vtx 


•39 


Public 


N 
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Vertex 



Listing Of Functions With Macros Available 



Function Name 


Description 


Page 


Scope 


VtxAsGrfLel 


Return list element in graph 


Vtx-2 


Friend 


VtxCounttn 


Count incoming edges 


Vtx-9 


Public 


VtxCountOut 


Count outgoing edges 


Vtx-11 


Public 


VtxDisconnectFromGrf 


Disconnect vertex from graph 


Vtx-15 


Public 


VtxGetClient 


Return client of vertex 


Vtx-21 


Public 


VtxGetFirstln 


Return first incoming edge 


Vtx-22 


Public 


VtxGetFirstOut 


Return first outgoing edge 


Vtx-23 


Public 


VlxGetGrt 


Return graph 


Vtx-24 


Friend 


VtxInGrt 


Is vertex in graph 


Vtx-26 


Public 


VtxStackSelup 


Set up values for topsort 


Vtx-28 


Friend 
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Class Exceptions Reference 



BlkClear( pBlk ) 

BLK-65: pBlk must be a valid Blk pointer. 

BlkDelnit(pBlk) 

BLK - 89: pBlk must be a valid Blk pointer. 

BLK - 91: pBlk must be a valid Blk pointer. 

BlkExecute( pBlk, pObj ) 

BLK - 115: pBlk must be a valid Blk pointer. 

BLK - 1 16: pBlk must contain a non Null method pointer. 

BlkExecuteRetBooK pBlk, pObj ) 

BLK - 156: pBlk must be a valid Blk pointer. 

BLK - 157: pBlk must contain a non Null method pointer. 

BlkExecuteRetDataPtr( pBlk, pObj ) 

BLK - 197: pBlk must be a valid Blk pointer. 

BLK - 198: pBlk must contain a non Null method pointer. 

BlkExecuteRetFuncPtr( pBlk, pObj ) 

BLK - 238: pBlk must be a valid Blk pointer. 

BLK - 239: pBlk must contain a non Null method pointer. 

BlkExecuteRetInt( pBlk, pObj ) 

BLK - 279: pBlk must be a valid Blk pointer. 

BLK - 280: pBlk must contain a non Null method pointer. 
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Class Exceptions Reference 



BlkHasMethod( pBlk ) 

BLK - 317: pBlk must be a valid Blk pointer. 

Blklnit( pBlk, pMth) 

BLK - 343: pBlk must be a valid Blk pointer. 

BlkPrint( pBlk, pCio, item, level, name ) 

BLK - 380: pBlk must be a valid Blk pointer. 

BLK - 381: pCio must be a valid Cio pointer. 



BlkPushDataPtr( pBlk, p ) 



BLK -410: 
BLK -411: 



pBlk must be a valid Blk pointer. 

The total number of parameters must not be larger than the 
parameter array. 



BlkPushFuncPtr( pBlk, p ) 

BLK - 441 : pBlk must be a valid Blk pointer. 



BlkPushLargeInt( pBlk, p ) 



BLK -470: 
BLK -471: 



pBlk must be a valid Blk pointer. 

The total number of parameters must not be larger than the 
parameter array. 



BlkPushMediumInt( pBlk, p ) 

BLK - 497: pBlk must be a valid Blk pointer. 

BLK - 498: The total number of parameters must not be larger than the 

parameter array. 



BlkSetMethod( pBlk, pMth ) 

BLK - 524: pBlk must be a valid Blk pointer. 

BLK - 525: pMth must be a valid Blk pointer. 
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Class Exceptions Reference 



ClsCreateMessages( pCls ) 



CLS-97: 



ClsCreateObject( pCls ) 



CLS-141 
CLS -142 
CLS -145 



ClsCreateObjectFast( pCls ) 



CLS-197: 
CLS -198 
CLS-201 



ClsCreateSupers( pCls ) 

CLS -233: 

ClsDeInit( pCls ) 

CLS-268: 
CLS -272: 

ClsDestroy( pCls ) 

CLS-305: 



pCis must be a valid Cls pointer. 



pQs must be a valid Cls pointer. 

The class must not have any sub-classes. 

Not enough memory to create object 



pCs must be a valid Cls pointer. 

The class must not have any sub-classes. 

Not enough memory to create object 



pQs must be a valid Cls pointer. 



pCls must be a valid Cls pointer. 
pCls must be a valid Cls pointer. 



pQs must be a valid Cls pointer. 



ClsDestroyMessages( pCls ) 

CLS - 334: pCls must be a valid Cls pointer. 



ClsDestroyObject( pCls, pObj ) 

CLS - 370: pCls must be a valid Cls pointer. 

CLS - 371 : pObj must be a valid Obj pointer. 

CLS - 372: The class must not have any sub-classes. 
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Class Exceptions Reference 



ClsDestroySuperClasses( pCls ) 

CLS • 402: pCls must be a valid Cls pointer. 

ClsFindFirstMsg( pCls, pStr ) 

CLS - 446: pQs must be a valid Cls pointer. 

ClsFindFirstSelectorIndex( pCls, pStr ) 

CLS - 490: pCls must be a valid Cls pointer. 

ClsFindMsg( pCls, pStr ) 

CLS - 529: pCls must be a valid Cls pointer. 

ClsFindSelectorIndex( pCls, pStr ) 

CLS - 572: pCls must be a valid Cls pointer. 

ClsFindSuperClass( pCls, pStr ) 

CLS - 609: pQs must be a valid Cls pointer. 

ClsGetMessageCountf pCls ) 

CLS - 641 : pQs must be a valid Cls pointer. 

ClsGetMethodAndOffset( pCls, m, ppMth, pOffset ) 

CLS - 692: pQs must be a valid Cls pointer. 

CLS - 693: The message number must be greater than or equal to zero, and 

less than the number of messages. 

ClsGetName( pCls ) 

CLS - 721 : pCls must be a valid Cls pointer. 
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Class Exceptions Reference 



ClsGetNthMsg( pCls, n ) 

CLS - 755: pQs must be a valid Cls pointer. 

CLS - 756: The message number must be greater than or equal to zero, and 

less than the number of messages. 

ClsGetNthSuperClass( pCls, n ) 

CLS -788: pQs must be a valid Cls pointer. 

CLS - 789: The super class index must be greater than or equal to zero, and 

less than the number of superclasses. 

ClsGetObjectSize( pCls ) 

CLS - 821 : pQs must be a valid Cls pointer. 

ClsGetOf fsetForMsg( pCls, m ) 

CLS - 861 : pCls must be a valid Cls pointer. 

CLS - 862: The message number must be greater than or equal to zero, and 

less than the number of messages. 

ClsGetOffsetOfNthSuper( pCls, n ) 

CLS - 899: pQs must be a valid Cls pointer. 

CLS - 900: The super class index must be greater than or equal to zero, and 

less than the number of superclasses. 

ClsGetRootSubClass( pCls ) 

CLS - 932: pQs must be a valid Cls pointer. 

ClsGetRootSubObjectOffset( pCls ) 

CLS - 966: pCls must be a valid Cls pointer. 

ClsGetRootSubObjectSize( pCls ) 

CLS -998: pCls must be a valid Cls pointer. 
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Class Exceptions Reference 



ClsGetSize( pCls) 

CLS - 1029: pQs must be a valid Cls pointer. 

ClsGetSubClass( pCls ) 

CLS - 1061 : pQs must be a valid Cls pointer. 

ClsGetSubObjectOffset( pCls ) 

CLS - 1092: pQs must be a valid Cls pointer. 

ClsGetSuperClassCount( pCls ) 

CLS - 1123: pQs must be a valid Cls pointer. 

ClsGetSuperClassIndex( pCls ) 

CLS - 1152: pCls must be a valid Cls pointer. 



ClsInit(pCls,pMcl) 



CLS -1183: 
CLS -1184: 
CLS -1187: 
CLS -1189 



pMcl must be a valid Mcl pointer. 

pQs must be a valid Cls pointer. 

Not enough memory to allocate superclasses 

Not enough memory to allocate messages 



ClsIsRoot( pCls ) 

CLS - 1223: pQs must be a valid Cls pointer. 

ClsOffsetSupers( pClsSub, pClsSuper, offset ) 

CLS - 1252: pQsSub must be a valid Cls pointer. 

CLS - 1253: pClsSuper must be a valid Cls pointer. 

ClsPrint( pCls, pCio, item, level, name ) 

CLS - 1293: pQs must be a valid Cls pointer. 

CLS - 1294: pCio must be a valid Cio pointer. 
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ClsSendDestroy( pCls ) 

CLS - 1327: pQs must be a valid Cls pointer. 



ClsSendObjectMessage( pCls, pObj, m, pBlk ) 



CLS -1373 
CLS -1374 
CLS -1375 

CLS -1376: 



pQs must be a valid Cls pointer. 
pObj must be a valid Obj pointer. 

The message number must be greater than or equal to zero, and 
less than the number of messages. 
pBlk must be a valid Blk pointer. 



ClsSendObjectMessageReturnInt( pCls, pObj, m, pBlk ) 



CLS -1426 
CLS -1427: 
CLS -1428: 



pCls must be a valid Cls pointer. 



pObj must be a valid Obj pointer. 

The message number must be greater than or equal to zero, and 
less than the number of messages. 
CLS - 1429: pBlk must be a valid Blk pointer. 

ClsSendObjectMessageReturnPtr( pCls, pObj, m, pBlk ) 



CLS -1479 
CLS -1480 
CLS -1481 



pCls must be a valid Cls pointer. 



pObj must be a valid Obj pointer. 

The message number must be greater than or equal to zero, and 
less than the number of messages. 
CLS - 1482: pBlk must be a valid Blk pointer. 



ClsSuperClassOf ( pClsSub, pClsSuper, index, offset ) 

CLS - 1511: pClsSub must be a valid Cls pointer. 

CLS - 1512: pQsSuper must be a valid Cls pointer. 

CLS - 1513: pClsSub must not be identical to pQsSuper 



DllAppend( pDll, pLel, pLelApp ) 

DLL - 83: pDll must be a valid DU pointer. 

DLL - 84: pLelApp must be a valid Lei pointer. 
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DllAppendLast( pDll, pLel ) 



DLL - 118: 
DLL -119: 



pDll must be a valid DU pointer. 
pLel must be a valid Lei pointer. 



DllAsObj( pDll ) 



DLL -149: 



pDll must be a valid Dll pointer. 



DllClear( pDll ) 

DLL - 175: 



pDll must be a valid Dll pointer. 



DllCut( pDll, pLel ) 



DLL -208: 
DLL -209: 
DLL -210: 



pDll must be a valid Dll pointer. 
pLel must be a valid Lei pointer. 
pLel must be in the list pDll. 



DUCutChildren( pDll ) 

DLL -236: 



pDll must be a valid Dll pointer. 



DllCutRange( pDll, pLelBeg, pLelEnd ) 



DLL - 282 
DLL - 283 
DLL - 284 
DLL -285: 

DLL -286: 



pDll must be a valid Dll pointer. 
pLelBeg must be a valid Lei pointer. 
pLelEnd must be a valid Lei pointer. 

If pLelBeg does not equal pLelEnd then pLelBeg must precede 
pLelEnd. 

pLelBeg must be in the list pDll. 



DUDeInit( pDll) 



DLL -316: 
DLL -317: 
DLL -319: 



pDll must be a valid Dll pointer. 
pDll cannot have any list elements 
pDll must be a valid Dll pointer. 



DllDestroy( pDll ) 



DLL -348: 
DLL - 349: 



pDll must be a valid Dll pointer. 
pDll must not have a sub-object 
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DllGetClient( pDll, offset ) 

DLL - 384: pDll must be a valid DU pointer. 

DllGetFirst(pDll) 

DLL - 415: pDll must be a valid Dll pointer. 

DllGetLasK pDll ) 

DLL - 447: pDll must be a valid Dll pointer. 

DUGetNth( pDll, index ) 

DI L - 484: pDll must be a valid Dll pointer. 

DllGetSize( pDll ) 

DLL - 512: pDll must be a valid Dll pointer. 

DUInit( pDll) 

DLL - 540: pDll must be a valid Dll pointer. 

Dlllnsert( pDll, pLel, pLellns ) 

DLL - 581: pDll must be a valid Dll pointer. 

DLL - 582: pLellns must be a valid Lei pointer. 

DllInsertFirst( pDll, pLel ) 

DLL - 615: pDll must be a valid Dll pointer. 

DLL - 616: pLel must be a valid Lei pointer. 

DUIsEmpty( pDll ) 

DLL - 644: pDll must be a valid Dll pointer. 
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DULelClientCount( pDll, offset, pBlk ) 

DLL - 691: pDU must be a valid DU pointer. 

DLL - 692: pBlk must be a valid Blk pointer. 

DULelCUentFind( pDll, offset, pBlk ) 

DLL - 739: pDll must be a valid DU pointer. 

DLL - 740: pBlk must be a valid Blk pointer. 

DULelCUentFirst( pDll, offset ) 

DLL - 776: pDll must be a valid DU pointer. 

DULelCUentGetNth( pDll, offset, index ) 

DLL - 819: pDll must be a valid DU pointer. 

DULelClientLast( pDU, offset ) 

DLL - 856: pDll must be a valid DU pointer. 

DULelCUentVisitBwd( pDll, offset, pBlk ) 

DLL - 901: pDll must be a valid DU pointer. 

DLL -902: pBlk must be a valid Blk pointer. 

DULelCHentVisitFwd( pDll, offset, pBlk ) 

DLL - 946: pDU must be a valid DH pointer. 

DLL - 947: pBlk must be a valid Blk pointer. 

DllNotifyCutRange( pDll, pLelBeg, pLelEnd ) 

DLL - 974: pDll must be a valid DU pointer. 

DLL - 975: pLelBeg must be a valid Lei pointer. 

DLL - 976: pLelEnd must be a valid Lei pointer. 
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DUNotifyPasteRange( pDll, pLelBeg, pLelEnd ) 

DLL - 1005: pDll must be a valid Dll pointer. 

DLL - 1006: pLelBeg must be a valid Lei pointer. 

DLL - 1007: pLelEnd must be a valid Lei pointer. 



DllPasteRangeAfter( pDll, pLel, pLelBeg, pLelEnd ) 



DLL - 1063 
DLL -1064 
DLL -1065 
DLL -1066: 

DLL - 1067; 
DLL - 1072 
DLL -1073 



pDll must be a valid Dll pointer. 
pLelBeg must be a valid Lei pointer. 
pLelEnd must be a valid Lei pointer. 

If pLelBeg does not equal pLelEnd then pLelBeg must precede 
pLelEnd. 

pLelBeg must not already be in a list. 
pLel must be a valid Lei pointer. 
pLel must be in the list pDll. 



DllPasteRangeBefore( pDll, pLel, pLelBeg, pLelEnd ) 



DLL -1128 
DLL -1129 
DLL -1130 
DLL - 1131 

DLL -1132 
DLL - 1137 
DLL -1138: 



pDll must be a valid Dll pointer. 
pLelBeg must be a valid Lei pointer. 
pLelEnd must be a valid Lei pointer. 

If pLelBeg does not equal pLelEnd then pLelBeg must precede 
pLelEnd. 

pLelBeg must not already be in a list. 
pLel must be a valid Lei pointer. 
pLel must be in the list pDll. 



DllPasteRangeFirst( pDll, pLelBeg, pLelEnd ) 

DLL - 1 195: pDll must be a valid Dll pointer. 

DLL - 1196: pLelBeg must be a valid Lei pointer. 

DLL - 1 197: pLelEnd must be a valid Lei pointer. 

DUPasteRangeLast( pDll, pLelBeg, pLelEnd ) 

DLL - 1253: pDll must be a valid Dll pointer. 

DLL - 1254: pLelBeg must be a valid Lei pointer. 

DLL - 1255: pLelEnd must be a valid Lei pointer. 



DUSendDestroy( pDll ) 

DLL - 1282: pDll must be a valid Dll pointer. 
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DpaAppend( pDpa, pObj ) 

DPA - 96: pDpa must be a valid Dpa pointer. 



DpaClear( pDpa ) 



DPA -122: 



pDpa must be a valid Dpa pointer. 



DpaCount( pDpa, pBlk ) 



DPA - 171: 
DPA - 172: 



pDpa must be a valid Dpa pointer. 
pBlk must be a valid Blk pointer. 



DpaCountRange( pDpa, beg, end, pBlk ) 



DPA - 233 
DPA - 234 
DPA - 235 
DPA -236 
DPA -237: 



pDpa must be a valid Dpa pointer. 
The index beg must be in the range [0-END]. 
The index end must be in the range [0-END]. 
beg must be less than or equal to end. 
pBlk must be a valid Blk pointer. 



DpaDeInit( pDpa ) 



DPA -271: 
DPA -274: 



pDpa must be a valid Dpa pointer. 
pDpa must be a valid Dpa pointer. 



DpaDelete( pDpa, beg, n ) 



DPA - 316: 
DPA - 317: 
DPA - 318 



pDpa must be a valid Dpa pointer. 

The index beg must be in the range [0-END]. 

(beg + n) must be less than or equal to the size of the array. 



DpaDestroy( pDpa ) 

DPA -346: 



pDpa must be a valid Dpa pointer. 



DpaExpand( pDpa, beg, n ) 



DPA - 397: 
DPA - 398 
DPA - 399 



pDpa must be a valid Dpa pointer, 
beg must be in the range [0:DpaGetSize] 
n must be greater than zero 
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DpaFind( pDpa, pBlk ) 



DPA-448: 
DPA-449: 



pDpa must be a valid Dpa pointer. 
pBlk must be a valid Blk pointer. 



DpaFindPtrBwd( pDpa, beg, pObj ) 



DPA -493: 
DPA - 494: 



pDpa must be a valid Dpa pointer. 

The index beg must be in the range [0-END]. 



DpaFindPtrFwd( pDpa, beg, pObj ) 



DPA - 539: 
DPA -540: 



pDpa must be a valid Dpa pointer. 

The index beg must be in the range [0-END]. 



DpaFindRangeBwd( pDpa, beg, end, pBlk ) 



DPA - 601 
DPA - 602 
DPA - 603 
DPA - 604 



pDpa must be a valid Dpa pointer. 
The index beg must be in the range [0-END]. 
The index end must be in the range [0-END]. 
beg must be less than or equal to end. 



DpaFindRangeFwd( pDpa, beg, end, pBlk ) 



DPA - 664 
DPA - 665 
DPA - 666: 
DPA - 667: 



pDpa must be a valid Dpa pointer. 
The index beg must be in the range [0-END]. 
The index end must be in the range [0-END]. 
beg must be less than or equal to end. 



DpaGetNth( pDpa, n ) 



DPA - 706: 
DPA - 707: 



pDpa must be a valid Dpa pointer. 

The index n must be in the range [0-END]. 



DpaGetLast( pDpa ) 



DPA - 737: 
DPA - 738: 



pDpa must be a valid Dpa pointer. 
The array must have at least one element 
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DpaGetSize( pDpa ) 

DPA-769: 



pDpa must be a valid Dpa pointer. 



Dpalnit( pDpa, s, i ) 



DPA -806: 
DPA -807: 
DPA -808: 
DPA -810: 



pDpa cannot be NULL 

The increment must be greater than one 

The initial size must be greater than or equal to zero 

pDpa must be a valid Dpa pointer. 



DpaNewArray( pDpa ) 



DPA -837: 
DPA - 846: 
DPA -850: 



pDpa must be a valid Dpa pointer. 

The allocated size is not a multiple of the increment 

Not enough memory to allocate array 



DpaResize( pDpa, n ) 



DPA -874: 
DPA -875: 



pDpa must be a valid Dpa pointer. 
N must be greater than or equal to zero 



DpaSetNth( pDpa, index, pObj ) 



DPA - 915: 
DPA -916: 



pDpa must be a valid Dpa pointer. 

The index index must be in the range [0-END]. 



DpaSetRegionNull( pDpa, beg, n ) 



DPA - 958 
DPA -959 
DPA - 960: 



pDpa must be a valid Dpa pointer. 

The index beg must be in the range [0-END]. 

(beg + n) must be less than or equal to the size of the array. 



DpaSetSize( pDpa, size ) 



DPA - 995: pDpa must be a valid Dpa pointer. 

DPA - 996: The new size must be greater than or equal to zero 



DpaShiftDown( pDpa, n ) 



DPA - 1043: pDpa must be a valid Dpa pointer. 

DPA - 1044: N must be greater than zero and less than the aray size 



Appendix A - 14 



Class Exceptions Reference 



DpaShiftUp( pDpa, n ) 



DPA - 1075: pDpa must be a valid Dpa pointer. 

DPA - 1076: N must be greater than zero and less than the array size 



DpaVisit( pDpa, pBlk ) 

DPA - 1114: pDpa must be a valid Dpa pointer. 

DPA - 1 1 15: pBlk must be a valid Blk pointer. 



DpaVisitClient( pDpa, offset, pBlk ) 

DPA - 1163: pDpa must be a valid Dpa pointer. 

DPA - 1164: pBlk must be a valid Blk pointer. 



DpaVisitRange( pDpa, beg, end, pBlk ) 

DPA - 1216: pDpa must be a valid Dpa pointer. 

DPA - 1217: The index beg must be in the range [0-END]. 

DPA - 1218: The index end must be in the range [0-END] . 

DPA -1219: beg must be less than or equal to end. 



DpaVisitRegion( pDpa, beg, n, pBlk ) 

DPA - 1272: pDpa must be a valid Dpa pointer. 

DPA - 1273: The index beg must be in the range [0-END]. 

DPA - 1274: (beg + n) must be less than or equal to the size of the array. 



DpaVisitSelf AndSuccessors( pDpa, beg, pBlk ) 

DPA - 1318: pDpa must be a valid Dpa pointer. 

DPA - 1319: The index beg must be in the range [0-END]. 

DPA - 1320: pBlk must be a valid Blk pointer. 



EdgAsGrfLeK pEdg ) 

EDG - 101: pEdg must be a valid Edg pointer. 
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EdgAsInLeK pEdg ) 



EDG - 134: 



pEdg must be a valid Edg pointer. 



EdgAsObj( pEdg) 

EDG - 166: 



pEdg must be a valid Edg pointer. 



EdgAsOutLeK pEdg ) 



EDG -199: 



pEdg must be a valid Edg pointer. 



EdgClear( pEdg ) 



EDG -223: 
EDG - 230: 



pEdg must be a valid Edg pointer. 
Failed to disconnect all vertices 



EdgCompareInVtx( pEdg, pVtx, offset, pBlk ) 



EDG - 289: 
EDG - 290: 
EDG - 291 



pEdg must be a valid Edg pointer. 
pVtx must be a valid Vtx pointer. 
pBlk must be a valid Blk pointer. 



EdgConnectToGrf( pEdg, pGrf ) 



EDG - 327 
EDG -328 
EDG -329 
EDG - 330: 



pEdg must be a valid Edg pointer. 

pGrf must be a valid Grf pointer. 

pEdg must not already be linked to a graph. 

pEdg must not be linked to any vertices. 



EdgConnectToVertices( pEdg, pVtxI, pVtxO ) 



EDG -367: 
EDG -368: 
EDG - 369 
EDG - 370: 
EDG -371 
EDG -372 
EDG - 373 



pEdg must be a valid Edg pointer. 

pVtxI must be a valid Vtx pointer. 

pVtxO must be a valid Vtx pointer. 

pEdg must be linked to a graph. 

The Vertex pVtxI must be linked to a graph. 

The Vertex pVtxO must be linked to a graph. 

pEdg must not be linked to any vertices. 
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EdgDelniK pEdg ) 



EDG -402: 
EDG-403: 
EDG - 404 
EDG-410: 



pEdg must be a valid Edg pointer. 
pEdg must not already be linked to a graph. 
pEdg must not be linked to any vertices. 
pEdg must be a valid Edg pointer. 



EdgDestroy( pEdg ) 



EDG -438: 
EDG -439: 



pEdg must be a valid Edg pointer. 
pEdg must not have a sub-object 



EdgDisconnectFromGrf ( pEdg ) 



EDG -469: 
EDG -470: 
EDG -471: 



pEdg must be a valid Edg pointer. 

pEdg must be linked to a graph. 

pEdg must not be linked to any vertices. 



EdgDisconnectFromVertices( pEdg ) 



EDG -499 
EDG -500: 
EDG -506: 



pEdg must be a valid Edg pointer. 

pEdg must be linked to a graph. 

pEdg must not be linked to any vertices. 



EdgGetClient( pEdg, offset ) 

EDG - 538: pEdg must be a valid Edg pointer. 



EdgGetGrf(pEdg) 

EDG -569: 



pEdg must be a valid Edg pointer. 



EdgGetInVtx( pEdg ) 



EDG -605: 
EDG -609: 



pEdg must be a valid Edg pointer. 
pEdg points to an invalid Vertex 



EdgGetNextIn( pEdg ) 



EDG - 642: 



pEdg must be a valid Edg pointer. 
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EdgGetNextOut( pEdg ) 

EDG-677: 

EdgGetOutVtx( pEdg ) 

EDG-713: 
EDG-717: 



pEdg must be a valid Edg pointer. 



pEdg must be a valid Edg pointer. 
pEdg points to an invalid Vertex 



EdgGetVertices( pEdg, ppVtxI, ppVtxO ) 

EDG - 760: pEdg must be a valid Edg pointer. 

EdgHasVertices( pEdg ) 

EDG - 790: pEdg must be a valid Edg pointer. 



EdgInGrf( pEdg ) 

EDG -821: 

Edglnit(pEdg) 

EDG -850: 

EdgSendDestroy( pEdg ) 

EDG -880: 



pEdg must be a valid Edg pointer. 



pEdg must be a valid Edg pointer. 



pEdg must be a valid Edg pointer. 



EdgUpdateInVtx( pEdg, pVtxI ) 



EDG -912: 
EDG -913 
EDG -914 
EDG -915 



pEdg must be a valid Edg pointer. 
pEdg must be linked to a graph. 
pEdg must be linked to two vertices. 
The Vertex pVtxI must be linked to a graph. 
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EdgUpdateOutVtx( pEdg, pVtxO ) 



EDG-946 
EDG-947: 
EDG-948 
EDG-949 



pEdg must be a valid Edg pointer. 

pEdg must be linked to a graph. 

pEdg must be linked to two vertices. 

The Vertex pVtxO must be linked to a graph. 



GrfAnyCydes( pGrf ) 

GRF-100: 

GrfAsEdgDIK pGrf ) 

GRF-132: 



pGrf must be a valid Grf pointer. 



pGrf must be a valid Grf pointer. 



GrfAsObj(pGrf) 



GRF -165: 



pGrf must be a valid Grf pointer. 



GrfAsVtxDU(pGrf) 

GRF -197: 



pGrf must be a valid Grf pointer. 



GrfBasicTopologicalSort( pGrf, keepSort, fwdOnly ) 



GRF -251: 



pGrf must be a valid Grf pointer. 



GrfClear( pGrf ) 



GRF -414: 
GRF -419: 
GRF -420: 



pGrf must be a valid Grf pointer. 
Failed to disconnect all vertices 
Failed to disconnect all edges 



GrfCountEdg( pGrf ) 

GRF -451: 



pGrf must be a valid Grf pointer. 



GrfCountVtx( pGrf ) 

GRF -481: 



pGrf must be a valid Grf pointer. 
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GrfDeInit( pGrf ) 



GRF -513 
GRF-514: 
GRF -515 
GRF -523 



pGrf must be a valid Grf pointer. 
pGrf must not contain any vertices 
pGrf must not contain any edges 
pGrf must be a valid Grf pointer. 



GrfDestroy( pGrf ) 



GRF - 551 : pGrf must be a valid Grf pointer. 

GRF - 552: pGrf must not have a sub-object 



GrfDoTopologicalSort( pGrf ) 

GRF -588: pGrf must be a valid Grf pointer. 

GrfFindEdgClient( pGrf, offset, pBlk ) 

GRF - 640: pGrf must be a valid Grf pointer. 

GRF - 641 : pBlk must be a valid Blk pointer. 

GrfFindVtxClient( pGrf, offset, pBlk ) 

GRF - 693: pGrf must be a valid Grf pointer. 

GRF - 694: pBlk must be a valid Blk pointer. 

GrfGetClient( pGrf, offset ) 

GRF - 728: pGrf must be a valid Grf pointer. 

Grflnit( pGrf ) 

GRF - 757: pGrf must be a valid Grf pointer. 

GrfSendDestroy( pGrf ) 

GRF - 789: pGrf must be a valid Grf pointer. 
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GrfVisitEdgClient( pGrf, offset, pBlk ) 

GRF - 834: pGrf must be a valid Grf pointer. 

GRF - 835: pBlk must be a valid Blk pointer. 

GrfVisitVtxClient( pGrf, offset, pBlk ) 

GRF - 879: pGrf must be a valid Grf pointer. 

GRF -880: pBlk must be a valid Blk pointer. 

GrfVisitVtxCuentInTopOrderBwd( pGrf, offset, pBlk ) 

GRF - 927: pGrf must be a valid Grf pointer. 

GRF - 928: pBlk must be a valid Blk pointer. 

GrfVisitVtxCuentInTopOrderFwd( pGrf, offset, pBlk ) 

GRF - 975: pGrf must be a valid Grf pointer. 

GRF -976: pBlk must be a valid Blk pointer. 

JulAddDays( pjul, dy ) 

JUL - 68: pjul must be a valid Jul pointer. 

JulAddDaysU pjul, dy ) 

JUL - 100: pjul must be a valid Jul pointer. 

JulAddMonths( pjul, mnth ) 

JUL - 138: pjul must be a valid Jul pointer. 

JulAddQuarters( pjul, qtrs ) 

JUL - 208: pjul must be a valid Jul pointer. 

JulAddYears( pjul, yr ) 

JUL - 279: pjul must be a valid Jul pointer. 
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JulCalendarToJulian( pjul, year, month, day ) 



JUL -321 
JUL -322 
JUL -323 
JUL -324 



pjul must be a valid Jul pointer. 

Year must be in the range [1582:4713] 

Month must be in the range [1:12] 

Day must be a valid day for the month and year specified 



JulCopy( pJulD, pJulS ) 



JUL -364: 
JUL -365: 



pJulD must be a valid Jul pointer. 
pJulS must be a valid Jul pointer. 



JulDateStrToJulian( pjul, pStr, format ) 

JUL -411: pjul must be a valid Jul pointer. 



JulDayOfWeek( pjul ) 



JUL -454: 



pjul must be a valid Jul pointer. 



JulDayOfYear( pjul ) 

JUL -489: 



pjul must be a valid Jul pointer. 



JulDaysInMonth( pjul ) 



JUL -532: 



pjul must be a valid Jul pointer. 



JulDaysInQuarter( pjul ) 



JUL -577: 



pjul must be a valid Jul pointer. 



JulDaysInYear( pjul ) 



JUL -624: 



pjul must be a valid Jul pointer. 



JulDiff( pjull, pjul2 ) 



JUL - 663 
JUL -664 
JUL -667: 



pjull must be a valid Jul pointer. 
pjul2 must be a valid Jul pointer. 
Difference too large for Mediumlnt 
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JulDiffL( pjull, pjul2 ) 



JUL - 703: pjull must be a valid Jul pointer. 

JUL - 704: pjul2 must be a valid Jul pointer. 



JulGetSystemJulianDay( pjul ) 

JUL - 737: pjul must be a valid Jul pointer. 

Jullnit( pjul ) 

None 

JulIsLeapYear( yr ) 

None 

JulIsMaxValue( pjul ) 

JUL - 829: pjul must be a valid Jul pointer. 



JulMax( pjul, pjull, pjul2 ) 



JUL -861 
JUL -862: 
JUL -863: 



JulMin( pjul, pjull, pjul2 ) 



JUL -894 
JUL -895 
JUL -896: 



pjul must be a valid Jul pointer, 
pjull must be a valid Jul pointer. 
pjul2 must be a valid Jul pointer. 



pjul must be a valid Jul pointer, 
pjull must be a valid Jul pointer. 
pjul2 must be a valid Jul pointer. 



JulMonthDayDiff ( pjul, mnth, dy ) 

JUL - 932: pjul must be a valid Jul pointer. 
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JulMonthStringC pjul, pStr ) 

JUL - 979: pjul must be a valid Jul pointer. 

JulQuarterString( pjul, pStr ) 

JUL - 1028: pjul must be a valid Jul pointer. 

JulSameDayMonth( pjull, pjul2 ) 

JUL - 1073: pjull must be a valid Jul pointer. 

JUL - 1074: pjul2 must be a valid Jul pointer. 

JulSetMaxDate( pjul ) 

JUL - 1107: pjul must be a valid Jul pointer. 

JulToCalendar( pjul, year, month, day ) 

JUL - 1 143: pjul must be a valid Jul pointer. 

JulToDateStr( pjul, pStr, format ) 

JUL - 1218: pjul must be a valid Jul pointer. 

JulValidateDate( pStr, format ) 

None 

JulWeekString( pjul, pStr ) 

JUL - 1328: pjul must be a valid Jul pointer. 

JulYearString( pjul, pStr ) 

JUL - 1375: pjul must be a valid Jul pointer. 

LelAsObj( pLel ) 

LEL - 73: pLel must be a valid Lei pointer. 
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LelClientCount( pLel, offset, pBlk ) 

LEL - 121: The list element can be NULL in which case the return value is 

zero and no items are processed 
LEL - 122: pBlk must be a valid Blk pointer. 

LEL - 125: An invalid ListElement pointer was encountered during the 

walk 

LelClientDll( pLel, offset ) 

LEL - 160: pLel must be a valid Lei pointer. 



LelClientFindRange( pLelBeg, pLelEnd, off set, pBlk ) 

LEL - 223: pLelBeg must be a valid Lei pointer. 

LEL - 224: pLelEnd must be a valid Lei pointer. 

LEL - 225: If pLelBeg does not equal pLelEnd then pLelBeg must precede 

pLelEnd. 

LEL - 226: pBlk must be a valid Blk pointer. 

LEL - 231: An invalid List Element pointer was encountered during the 

walk 

LelClientNext( pLel, offset ) 

LEL - 272: pLel must be a valid Lei pointer. 



LelClientPrev( pLel, offset ) 

LEL - 309: pLel must be a valid Lei pointer. 

LelCUentVisitBwd( pLel, offset, pBlk ) 

LEL - 356: The list element may be NULL in which case no elements are 

visited 

LEL - 357: pBlk must be a valid Blk pointer. 

LEL - 360: An invalid ListElement pointer was encountered during the 

walk 
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LelCHentVisitFwd( pLel, offset, pBlk ) 

LEL - 408: The list element may be NULL in which case no elements are 

visited 

LEL - 409: pBlk must be a valid Blk pointer. 

LEL - 412: An invalid ListElement pointer was encountered during the 

walk 



LelClientVisitPredecessors( pLel, offset, pBlk ) 

LEL - 459: pLel must be a valid Lei pointer. 

LEL - 460: pBlk must be a valid Blk pointer. 

LelCHentVisitRange( pLelBeg, pLelEnd, offset, pBlk ) 



LEL - 520: pLelBeg must be a valid Lei pointer. 

LEL - 521: pLelEnd must be a valid Lei pointer. 

LEL - 522: If pLelBeg does not equal pLelEnd then pLelBeg must precede 

pLelEnd. 

LEL - 523: pBlk must be a valid Blk pointer. 

LEL - 529: An invalid ListElement pointer was encountered during the 

walk 



LelClientVisitSuccessors( pLel, offset, pBlk ) 

LEL - 577: pLel must be a valid Lei pointer. 

LEL - 578: pBlk must be a valid Blk pointer. 



LelCountRange( pLelBeg, pLelEnd ) 

LEL - 621: pLelB must be a valid Lei pointer, 

LEL - 622: pLelE must be a valid Lei pointer. 

LEL -623: If pLelBeg does not equal pLelEnd then pLelBeg must precede 

pLelEnd. 

LEL - 632: An invalid ListElement pointer was encountered during the 

walk 



LelCut( pLel ) 

LEL - 663: pLel must be a valid Lei pointer. 
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LelCutRange( pLelBeg, pLelEnd ) 



LEL -706: 
LEL -707: 
LEL -708; 



p Lei Beg must be a valid Lei pointer. 
pLelEnd must be a valid Lei pointer. 

If pLelBeg does not equal pLelEnd then pLelBeg must precede 
pLelEnd. 



LelCutRangeFromList( pLelBeg, pLelEnd ) 



LEL-745: 
LEL-746: 
LEL-747: 

LEL-756: 



pLelBeg must be a valid Lei pointer. 
pLelEnd must be a valid Lei pointer. 

If pLelBeg does not equal pLelEnd then pLelBeg must precede 
pLelEnd. 

An invalid ListElement pointer was encountered while walking 
through the range 



LelDeInit( pLel) 



LEL-790: 
LEL -791 
LEL-792 
LEL-794 



pLel must be a valid Lei pointer. 

The list element must not be connected to any other elements 
The list element must not be in a list 
pLel is not a valid ListElement pointer 



LelDestroy( pLel ) 



LEL-824: 
LEL-825: 



pLel must be a valid Lei pointer. 

The instance must be the outermost subclass; it cannot have a 
sub-object 



LelGetClient( pLel, offset ) 

LEL - 857: pLel must be a valid Lei pointer. 



LelGetDll( pLel ) 

LEL -887: 



pLel must be a valid Lei pointer. 



LelGetNext( pLel ) 



LEL - 917: 



pLel must be a valid Lei pointer. 
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LelGetNthSuccessor( pLel, offset ) 

LEL - 953: pLel must be a valid Lei pointer. 



LelGetPrev( pLel ) 

LEL -985: 



pLel must be a valid Lei pointer. 



LelInList( pLel ) 



LEL - 1014: 



pLel must be a valid Lei pointer. 



Lellnit( pLel) 

LEL -1043: 



pLel must be a valid Lei pointer. 



LelPasteRangeAf ter( pLel, pLelBeg, pLelEnd ) 



LEL -1090: 
LEL -1091 
LEL -1092: 
LEL -1093 

LEL -1094: 
LEL -1095: 



pLel must be a valid Lei pointer. 
pLelBeg must be a valid Lei pointer. 
pLelEnd must be a valid Lei pointer. 

If pLelBeg does not equal pLelEnd then pLelBeg must precede 
pLelEnd. 

pLelBeg must not already be in a list. 

pLel cannot be identical to either pLelBeg or pLelEnd 



LelPasteRangeBefore( pLel, pLelBeg, pLelEnd ) 



LEL -1154: 
LEL -1155: 
LEL - 1156: 
LEL -1157: 

LEL- 1158: 
LEL - 1159: 



pLel must be a valid Lei pointer. 
pLelBeg must be a valid Lei pointer. 
pLelEnd must be a valid Lei pointer. 

If pLelBeg does not equal pLelEnd then pLelBeg must precede 
pLelEnd. 

pLelBeg must not already be in a list. 

pLel cannot be identical to either pLelBeg or pLelEnd 
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LelPasteRangeToList( pLeffieg, pLelEnd, pDll ) 

LEL - 1 196: pLelBeg must be a valid Lei pointer. 

LEL - 1197: pLelEnd must be a valid Lei pointer. 

LEL - 1 198: If pLelBeg does not equal pLelEnd then pLelBeg must precede 

pLelEnd. 

LEL - 1 199: pLelBeg must not already be in a list 

LEL - 1200: The list pDll can be NULL 

LEL - 1207: An invalid ListElement pointer was encountered while walking 

through the range 
LEL - 1214: pDll must be a valid Dll pointer. 



LelSendDestroy( pLel ) 



LEL -1242: 



pLel must be a valid Lei pointer. 



LelTest( pLel ) 



LEL - 1265 
LEL - 1266: 
LEL - 1269 
LEL -1271 



pLel cannot be NULL 

pLel must be a valid Lei pointer. 

The successor list element must point to pLel 

The predecessor list element must point to pLel 



LelVisitRatige( pLelBeg, pLelEnd, pBlk ) 



LEL - 1318: 
LEL - 1319: 
LEL - 1320: 

LEL -1321: 
LEL - 1326: 



pLelBeg must be a valid Lei pointer. 
pLelEnd must be a valid Lei pointer. 

If pLelBeg does not equal pLelEnd then pLelBeg must precede 
pLelEnd. 

pBlk must be a valid Blk pointer. 

An invalid ListElement pointer was encountered while walking 
through the range 



MclCreateClass( pMcl ) 



MCL-105: 
MCL-108: 



pMcl must be a valid Mcl pointer. 
Not enough memory to create class 



MclDestroyClass( pMcl, pCls ) 

MCL - 146: pMcl must be a valid Mcl pointer. 
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MclFindFirstSelector( pMcl, pStr ) 

MCL - 188: pMcl must be a valid Mcl pointer. 

MclFindSelector( pMcl, pStr ) 

MCL - 236: An Mms with a pMth == -1 must be followed by same selector 

MclFindSuperClass( pMcl, pStr ) 

MCL - 271: pMcl must be a valid Md pointer. 

MclGetClassName( pMcl ) 

MCL - 303: pMcl must be a valid Mcl pointer. 

MclGetClassSize( pMcl ) 

MCL - 331 : pMcl must be a valid Mcl pointer. 

MclGetMessageCount( pMcl ) 

MCL - 359: pMcl must be a valid Mcl pointer. 

MclGetNthMms( pMcl, n ) 

MCL - 389: pMcl must be a valid Mcl pointer. 

MCL - 390: The message number must be greater than or equal to zero, and 

less than the number of messages. 

MclGetNthOffset( pMcl, n ) 

MCL - 425: pMcl must be a valid Mcl pointer. 

MCL - 426: The super class index must be greater than or equal to zero, and 

less than the number of superclasses. 

MclGetNthSuper( pMcl, n ) 

MCL - 456: pMcl must be a valid Mcl pointer. 

MCL - 457: The super class index must be greater than or equal to zero, and 

less than the number of superclasses. 
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MclGetObjectSize( pMcl ) 

MCL - 482: pMcl must be a valid Md pointer. 

MclGetSuperClassC6unt( pMcl ) 

MCL - 508: pMcl must be a valid Mcl pointer. 

MclPrint( pMcl, pCio, item, level, name ) 

MCL - 544: pMcl must be a valid Mcl pointer. 

MCL - 545: pCio must be a valid Cio pointer. 

MclSendCreateClass( pMcl ) 

MCL - 586: pMcl must be a valid Mcl pointer. 

MCL - 593: pMcl failed to create the class 

MclSendDestroyClass( pMcl, pCls ) 

MCL - 617: pMcl must be a valid Mcl pointer. 

MclValidate(pMcl) 

MCL - 650: pMcl must be a valid Mcl pointer. 



MCL -652 
MCL -653 
MCL -654 
MCL -657: 
MCL -658 



The name component must not be NULL 
The number of messages must be in the range [0:1001 
The number of superclasses must be in the range [0:30] 
A create function must be supplied 
A destroy function must be supplied 



MclValidateMessages( pMcl ) 

MCL - 690: pMcl must be a valid Mcl pointer. 

MclValidateSuperClasses( pMcl ) 

MCL - 726: pMcl must be a valid Mcl pointer. 
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MemClear( pMem, s, i, n, os ) 



MEM - 86: 
MEM -87: 
MEM -88: 
MEM -89: 



pMem must be a valid Mem pointer, 
i must be less s. 

(i + n) must be less or equal to s. 
os must be greater than 0. 



MemCopy( pMem, s, di, n, i, os ) 



MEM - 128: 
MEM - 129: 
MEM -130: 
MEM -131: 
MEM - 132: 
MEM - 133: 



pMem must be a valid Mem pointer, 
i must be less s. 

(i + n) must be less or equal to s. 
os must be greater than 0. 
di must be less s. 
(di + n) must be less or equal to s. 



MemCutNSet( pMem, s, i, n, os, c ) 



MEM - 174: 
MEM - 175: 
MEM - 176: 
MEM - 177: 



pMem must be a valid Mem pointer, 
i must be less s. 

(i + n) must be less or equal to s. 
os must be greater than 0. 



MemDestroy( pMem ) 



MEM -216: 



pMem must be a valid Mem pointer. 



MemDuplicate( pMem, s, pMemS, os ) 



MEM -246: 
MEM -247: 
MEM -248: 



pMem must be a valid Mem pointer. 
pMemS must be a valid Mem pointer, 
os must be greater than 0. 



MemNew( amount ) 

None 



MemNewFasK amount ) 

None 
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MemPasteNSeK pMem, s, i, n, os, c ) 



MEM -363: 
MEM -364: 
MEM -365: 
MEM -366: 



pMem must be a valid Mem pointer, 
i must be less s. 

(i + n) must be less or equal to s. 
os must be greater than 0. 



MemSetChr( pMem, s, i, n, os, c ) 



MEM -403: 
MEM -404: 
MEM -405: 
MEM -406: 



pMem must be a valid Mem pointer, 
i must be less s. 

(i + n) must be less or equal to s. 
os must be greater than 0. 



MmsGetMethod( pMms ) 



MMS-88: 



pMms must be a valid Mms pointer. 



MmsGetSuper( pMms ) 



MMS - 144: 



pMms must be a valid Mms pointer. 



MmsGetSelector( pMms ) 

MMS - 181: pMms must be a valid Mms pointer. 



MmsPrint( pMms, pCio, item, level, name ) 



MMS -214: 
MMS -215: 



pMms must be a valid Mms pointer. 
pCio must be a valid Cio pointer. 



MmsValidate( pMms ) 



MMS -246: 
MMS -248: 



pMms must be a valid Mms pointer. 
pMms->selector must be a valid Str pointer. 



MscGetName( pMsc ) 

MSC-79: 



pMsc must be a valid Msc pointer. 
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MscGetMetaClass( pMsc ) 

MSC - 109: pMsc must be a valid Msc pointer. 



MscGetOffset( pMsc ) 



MSC - 143: 
MSC -146: 



pMsc must be a valid Msc pointer. 

The superobject offset must be in the range [0:2000] 



MscPrint( pMsc, pCio, item, level, name ) 



MSC - 178: 
MSC - 179: 



pMsc must be a valid Msc pointer. 
pCio must be a valid Go pointer. 



MscValidate( pMsc ) 



MSC - 215 
MSC -217: 
MSC - 218 
MSC -219 
MSC - 220: 
MSC -221 



pMsc must be a valid Msc pointer. 

A name must be supplied 

A valid MetaClas pointer must be supplied 

A pointer to an instance of the super-object must be supplied 

A pointer to an instance of the super-object must be supplied 

A pointer to a Mediumlnt must be supplied 



MsgDeInit( pMsg ) 



MSG - 80: 
MSG -81: 



MsgGetOffset( pMsg ) 



MSG -106: 



MsgGetMethod( pMsg ) 



MSG - 133: 



pMsg must be a valid Msg pointer. 
pMsg must be a valid Msg pointer. 



pMsg must be a valid Msg pointer. 



pMsg must be a valid Msg pointer. 



MsgGetSelector( pMsg ) 

MSG - 160: pMsg must be a valid Msg pointer. 
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Msglnit( pMsg, pCls, pMms ) 



MSG -190: 
MSG -191 
MSG-192 
MSG -203 

MSG-2G5: 
MSG -208: 
MSG -212: 



pQs must be a valid Cls pointer. 
pMms must be a valid Mms pointer. 
pMsg must be a valid Msg pointer. 

The superclass name referred to by pMms is not a superclass of 
pCls 

The selector is invalid for the superclass named by pMms 
pMms cannot override the selector named 
pMms cannot inherit the selector named 



MsgPrint( pMsg, pCio, item, level, name ) 



MSG - 249: 
MSG -250: 



pMsg must be a valid Msg pointer. 
pCio must be a valid Cio pointer. 



MsgSend( pMsg, pObj, pBlk ) 

MSG - 286: pMsg must be a valid Msg pointer. 

MSG - 287: pBlk must be a valid Blk pointer. 



MsgSendRetumInt( pMsg, pObj, pBlk ) 

MSG - 319: pMsg must be a valid Msg pointer. 

MSG - 320: pBlk must be a valid Blk pointer. 

MsgSendReturnPtr( pMsg, pObj, pBlk ) 

MSG - 352: pMsg must be a valid Msg pointer. 

MSG - 353: pBlk must be a valid Blk pointer. 



MsgSetSuperOffsetAndMethod( pMsg, pMsgSuper ) 

MSG - 382: pMsg must be a valid Msg pointer. 

MSG - 383: pMsgSuper must be a valid Msg pointer. 

ObjDelnit(pObj) 

OBJ - 83: pObj must be a valid Obj pointer. 

OBJ - 85: pObj must be a valid Obj pointer. 
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ObjDestroy( pObj ) 

OBJ - 1 16: pObj must be a valid Obj pointer. 

ObjGetClient( pObj, offset ) 

OBJ . 155: pObj must be a valid Obj pointer. 

ObjGetCUentOrNuU( pObj, offset ) 

OBJ- 198: pObjmaybeNULL 

ObjGetCls( pObj ) 

OBJ . 225: pObj must be a valid Obj pointer. 

ObjGetClsName( pObj ) 

OBJ - 252: pObj must be a valid Obj pointer. 

ObjGetImmediateClient( pObj ) 

OBJ- 282: pObj must be a valid Obj pointer. 

ObjGetMethodAndOffset( pObj, m, ppMth, pOffset ) 

OBJ- 324: pObj must be a valid Obj pointer. 

OBJ . 325: The message number must be greater than or equal to zero, and 

less than the number of messages. 

ObjGetNthSuperObject( pObj, n ) 

OBJ - 354: pObj must be a valid Obj pointer. 

OBJ - 355: The super class index must be greater than or equal to zero, and 

less than the number of superclasses. 

ObjGetRootClient( pObj ) 

OBJ . 386: pObj must be a valid Obj pointer. 
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ObjGetRootCUentSize( pObj ) 

OBJ - 415: pObj must be a valid Obj pointer. 

ObjGetSize( pObj ) 

OBJ - 442: pObj must be a valid Obj pointer. 

ObjGetSubObjectOffset( pObj ) 

OBJ - 471 : pObj must be a valid Obj pointer. 

ObjInit( pObj, pCls ) 

OBJ - 506: pQs must be a valid Cls pointer. 

OBJ - 507: pObj must be a valid Obj pointer. 

ObjIsRoot( pObj ) 

OBJ - 536: pObj must be a valid Obj pointer. 

ObjRespondsToSelector( pObj, pStr ) 

OBJ - 567: pObj must be a valid Obj pointer. 

ObjSendMessage( pObj, m, pBlk ) 

OBJ - 598: pObj must be a valid Obj pointer. 

OBJ - 599: The message number must be greater than or equal to zero, and 

less than the number of messages. 
OBJ - 600: pBlk must be a valid Blk pointer. 

ObjSendMessageReturnInt( pObj, m, pBlk ) 

OBJ - 635: pObj must be a valid Obj pointer. 

OBJ - 636: The message number must be greater than or equal to zero, and 

less than the number of messages. 
OBJ - 637: pBlk must be a valid Blk pointer. 
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ObjSendMessageReturnPtr( pObj, m, pBlk ) 

OBJ - 672: pObj must be a valid Obj pointer. 

OBJ - 673: The message number must be greater than or equal to zero, and 

less than the number of messages. 
OBJ - 674: pBlk must be a valid Blk pointer. 

StrBasicExtract( pStrD, pStrS, index, length ) 

STR - 62: pStrD must be a valid Str pointer. 

SIR -63: pStrS must be a valid Str pointer. 

StrExtract( pStrD, pStrS, idx, n ) 

STR -111: pStrD must be a valid Str pointer. 

STR - 1 12: pStrS must be a valid Str pointer. 

StrFromDate( pStr, format, year, month, day ) 

STR - 165: pStr must be a valid Str pointer. 

STR -178: Invalid format 

StrFromMediumInt( pStr, maxLen, num ) 

STR - 215: pStr must be a valid Str pointer. 

Strlnit( pStr ) 

STR - 248: pStr must be a valid Str pointer. 

StrReplaceSubStr( pStrOrg, pStrFrom, pStrTo, maxLen ) 



STR -285; 
STR - 286: 
STR - 287: 
STR - 288; 



pStrOrg must be a valid Str pointer. 
pStrFrom must be a valid Str pointer. 
pStrTo must be a valid Str pointer. 
maxLen must be in the range [0:128] 



StrSet( pStrD, pStrS ) 



STR - 329: pStrD must be a valid Str pointer. 

STR - 330: pStrS must be a valid Str pointer. 
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StiSqueeze( pStrD, pStrS, ch ) 



STR-360: 
STR-361: 



s must be a valid Str pointer. 
pStrD must be a valid Str pointer. 



StrToDate( pStr, format, year, month, day ) 



STR -412: 
STR -413: 
STR -427: 



pStr must be a valid Str pointer. 

The length of pStr must be less than 12 

Invalid format 



StrToLower( pStr ) 

STR -452: 

StrToMediumInt( pStr ) 

STR -483: 

StrToUpper( pStr ) 

STR - 509: 

TreAsDU( pTre ) 

TRE -80: 

TreAsLeK pTre ) 

TRE - 113: 

TreAsObj( pTre ) 

None 



pStr must be a valid Str pointer. 



pStr must be a valid Str pointer. 



pStr must be a valid Str pointer. 



pTre must be a valid Tre pointer. 



pTre must be a valid Tre pointer. 



TreClear( pTre ) 



TRE - 168: 
TRE - 172 
TRE -177: 



pTre must be a valid Tre pointer. 
pTre must have no child nodes. 
pTre must be the root node. 
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TreClient( pTre, offset ) 

TRE-214: pTre must be a valid Tre pointer. 

TreClientFindChild( pTre, offset, pBlk ) 

TRE -266: pTre must be a valid Tre pointer. 

TreClientFirstChild( pTre, offset ) 

TRE -307: pTre must be a valid Tre pointer. 

TreClientLastChild( pTre, offset ) 

TRE - 348: pTre must be a valid Tre pointer. 

TreClientLastLeaf ( pTre, offset ) 

TRE - 391: pTre must be a valid Tre pointer. 

TreClientNext( pTre, offset ) 

TRE - 432: pTre must be a valid Tre pointer. 

TreClientNextPreOrder( pTre, offset ) 

TRE - 475: pTre must be a valid Tre pointer. 

TreClientNextUncle( pTre, offset ) 

TRE - 519: pTre must be a valid Tre pointer. 

TreClientParent( pTre, offset ) 

TRE - 559: pTre must be a valid Tre pointer. 
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TreClientPrev( pTre, offset ) 

TRE-600: pTre must be a valid Tre pointer. 



TreClientPrevPreOrder( pTre, offset ) 

TRE -643: pTre must be a valid Tre pointer. 



TreClientVisitBranchInOrder( pTre, offset, pBlk ) 

TRE - 695: pTre must be a valid Tre pointer. 

TRE -696: pBlk must be a valid Blk pointer. 



TreClientVisitChildren( pTre, offset, pBlk ) 

TRE - 751 : pTre must be a valid Tre pointer. 

TRE -752: pBlk must be a valid Blk pointer. 

TreCUentVisitChildrenBwd( pTre, offset, pBlk ) 

TRE -805: pTre must be a valid Tre pointer. 

TRE -806: pBlk must be a valid Blk pointer. 

TreClientVisitDescBranchInOrder( pTre, offset, pBlk ) 

TRE - 862: pTre must be a valid Tre pointer. 

TRE -863: pBlk must be a valid Blk pointer. 

TreClientVisitDescInOrder( pTre, offset, pBlk ) 

TRE -922: pTre must be a valid Tre pointer. 

TRE - 923: pBlk must be a valid Blk pointer. 

TreClientVisitDescInOrderBwd( pTre, offset, pBlk ) 

TRE - 982: pTre must be a valid Tre pointer. 

TRE -983: pBlk must be a valid Blk pointer. 
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TreClientVisitDescLeaves( pTre, offset, pBlk ) 

TRE - 1041 : pTre must be a valid Tre pointer. 

TRE - 1042: pBlk must be a valid Blk pointer. 



TreClientVisitDescPreOrder( pTre, offset, pBlk ) 

TRE - 1100: pTre must be a valid Tre pointer. 

TRE - 1101: pBlk must be a valid Blk pointer. 



TreClientVisitInOrder( pTre, offset, pBlk ) 

TRE - 1157: pTre must be a valid Tre pointer. 

TRE - 1158: pBlk must be a valid Blk pointer. 



TreClientVisitInOrderBwd( pTre, offset, pBlk ) 

TRE - 1212: pTre must be a valid Tre pointer. 

TRE - 1213: pBlk must be a valid Blk pointer. 



TreClientVisitLeaves( pTre, offset, pBlk ) 

TRE - 1266: pTre must be a valid Tre pointer. 

TRE - 1267: pBlk must be a valid Blk pointer. 



TreClientVisitParents( pTre, offset, pBlk ) 

TRE - 1323: pTre must be a valid Tre pointer. 

TRE - 1324: pBlk must be a valid Blk pointer. 



TreClientVisitPreOrder( pTre, offset, pBlk ) 

TRE - 1379: pTre must be a valid Tre pointer. 

TRE - 1380: pBlk must be a valid Blk pointer. 

TreClientVisitRange( pTreBeg, pTreEnd, offset, pBlk ) 



TRE - 1445 
TRE - 1446 
TRE - 1447: 



pTreBeg must be a valid Tre pointer. 



pTreEnd must be a valid Tre pointer. 

If pTreBeg does not equal pTreEnd then pTreBeg must precede 
pTreEnd. 

TRE - 1448: pBlk must be a valid Blk pointer. 
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TreClientVisitSuccPreOrder( pTre, offset, pBlk ) 

TRE - 1503: pTre must be a valid Tre pointer. 

TRE-1504: pBlk must be a valid Blk pointer. 

TRE - 1508: An invalid Tree pointer was encountered while walking the tree 



TreClientVisitSuccessors( pTre, offset, pBlk ) 

TRE - 1561: pTre must be a valid Tre pointer. 

TRE - 1562: pBlk must be a valid Blk pointer. 



TreCutChildren( pTre ) 

TRE -1591: pTre must be a valid Tre pointer. 



TreCutRange( pTreBeg, pTreEnd ) 

TRE - 1632: pTreBeg must be a valid Tre pointer. 

TRE - 1633: pTreEnd must be a valid Tre pointer. 

TRE - 1634: If pTreBeg does not equal pTreEnd then pTreBeg must precede 

pTreEnd. 



TreDeInit( pTre ) 



TRE -1663 
TRE -1664 
TRE -1665 
TRE - 1669 



pTre must be a valid Tre pointer. 
pTre must be the root node. 
pTre must have no child nodes. 
pTre must be a valid Tre pointer. 



TreDestroy( pTre ) 

TRE - 1697: pTre must be a valid Tre pointer. 

TRE - 1698: pTre must not have a sub-object 

TreDestroyChildren( pTre ) 

TRE - 1730: pTre must be a valid Tre pointer. 
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TreFirstChild(pTre) 

TRE - 1764: 



pTre must be a valid Tre pointer. 



TreHasChildren( pTre ) 

TRE - 1794: pTre must be a valid Tre pointer. 



TreHasSiblings( pTre ) 

TRE - 1825: 

Trelnit( pTre ) 

TRE - 1854: 

TreIsChild( pTre ) 

TRE - 1884: 



pTre must be a valid Tre pointer. 



pTre must be a valid Tre pointer. 



pTre must be a valid Tre pointer. 



TreIsDirectAncestor( pTre, pTreA ) 



TRE - 1920: 
TRE - 1921: 



TreisRoot( pTre ) 

TRE - 1957: 

TreLastChild( pTre ) 

TRE - 1990: 

TreLastLeaf ( pTre ) 

TRE - 2026: 
TRE - 2031: 



pTre must be a valid Tre pointer. 
pTreA must be a valid Tre pointer. 



pTre must be a valid Tre pointer. 



pTre must be a valid Tre pointer. 



pTre must be a valid Tre pointer. 

An invalid Tree pointer was encountered while walking the tree 
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TreNext( pTre ) 

TRE-2063: 



pTre must be a valid Tre pointer. 



TreNextPreOrder( pTre ) 

TRE - 2097: pTre must be a valid Tre pointer. 



TreNextUncle( pTre ) 



TRE -2138: 
TRE -2142: 



pTre must be a valid Tre pointer. 

An invalid Tree pointer was encountered while walking the tree 



TreParent( pTre ) 

TRE -2178: 



pTre must be a valid Tre pointer. 



TrePasteRangeAfterSibling( pTre, pTreBeg, pTreEnd ) 



TRE -2226; 
TRE -2227: 
TRE - 2228 
TRE -2229 
TRE -2230: 

TRE -2231: 



pTre must be a valid Tre pointer. 
pTre must be a parent. 
pTreBeg must be a valid Tre pointer. 
pTreEnd must be a valid Tre pointer. 

If pTreBeg does not equal pTreEnd then pTreBeg must precede 
pTreEnd. 

pTreBeg must be the root node. 



TrePasteRangeBeforeSibling( pTre, pTreBeg, pTreEnd ) 



TRE - 2279 
TRE - 2280: 
TRE -2281 
TRE - 2282: 
TRE - 2283: 

TRE -2284: 



pTre must be a valid Tre pointer. 
pTre must be a parent 
pTreBeg must be a valid Tre pointer. 
pTreEnd must be a valid Tre pointer. 

If pTreBeg does not equal pTreEnd then pTreBeg must precede 
pTreEnd. 

pTreBeg must be the root node. 
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TrePasteRangeFirstChild( pTre, pTreBeg, pTreEnd ) 



TRE -2331 
TRE - 2332 
TRE - 2333 
TRE -2334 

TRE -2335: 



pTre must be a valid Tre pointer. 
pTreBeg must be a valid Tre pointer. 
pTreEnd must be a valid Tre pointer. 

If pTreBeg does not equal pTreEnd then pTreBeg must precede 
pTreEnd. 

pTreBeg must be the root node. 



TrePasteRangeLastChild( pTre, pTreBeg, pTreEnd ) 



TRE - 2382; 
TRE -2383 
TRE -2384 
TRE - 2385: 

TRE - 2386: 



pTre must be a valid Tre pointer. 
pTreBeg must be a valid Tre pointer. 
pTreEnd must be a valid Tre pointer. 

If pTreBeg does not equal pTreEnd then pTreBeg must precede 
pTreEnd. 

pTreBeg must be the root node. 



TrePrev( pTre ) 

TRE - 2419: 



pTre must be a valid Tre pointer. 



TrePrevPreOrder( pTre ) 

TRE - 2456: pTre must be a valid Tre pointer. 



TreSendDestroy( pTre ) 

TRE - 2488: pTre must be a valid Tre pointer. 



TreVisitBranchInOrder( pTre, pBlk ) 

TRE - 2535: pTre must be a valid Tre pointer. 

TRE - 2536: pBlk must be a valid Blk pointer. 



TreVisitChildren( pTre, pBlk ) 

TRE - 2581: pTre must be a valid Tre pointer. 

TRE - 2582: pBlk must be a valid Blk pointer. 
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TreVisitChildrenBwd( pTre, pBlk ) 

TRE-2627: pTre must be a valid Tre pointer. 

TRE-2628: pBlk must be a valid Blk pointer. 

TreVisitDescBranchInOrder( pTre, pBlk ) 

TRE - 2674: pTre must be a valid Tre pointer. 

TRE - 2675: pBlk must be a valid Blk pointer. 

TreVisitDescInOrder( pTre, pBlk ) 

TRE -2720: pTre must be a valid Tre pointer. 

TRE - 2721: pBlk must be a valid Blk pointer. 

TreVisitDescInOrderBwd( pTre, pBlk ) 

TRE - 2766: pTre must be a valid Tre pointer. 

TRE - 2767: pBlk must be a valid Blk pointer. 

TreVisitDescPreOrder( pTre, pBlk ) 

TRE - 2811: pTre must be a valid Tre pointer. 

TRE -2812: pBlk must be a valid Blk pointer. 

TreVisitInOrder( pTre, pBlk ) 

TRE -2857: pTre must be a valid Tre pointer. 

TRE - 2858: pBlk must be a valid Blk pointer. 

TreVisitInOrderBwd( pTre, pBlk ) 

TRE - 2903: pTre must be a valid Tre pointer. 

TRE - 2904: pBlk must be a valid Blk pointer. 

TreVisitLeaves( pTre, pBlk ) 

TRE - 2948: pTre must be a valid Tre pointer. 

TRE -2949: pBlk must be a valid Blk pointer. 
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TreVisitParents( pTre, pBlk ) 



TRE - 2992: pTre must be a valid Tre pointer. 

TRE - 2993: pBlk must be a valid Blk pointer. 



TreVisitPreOrder( pTre, pBlk ) 

TRE -3038: pTre must be a valid Tre pointer. 

TRE - 3039: pBlk must be a valid Blk pointer. 

TreVisitRange( pTreBeg, pTreEnd, pBlk ) 

TRE -3093: pTreBeg must be a valid Tre pointer. 

TRE - 3094: pTreEnd must be a valid Tre pointer. 

TRE - 3095: If pTreBeg does not equal pTreEnd then pTreBeg must precede 

pTreEnd. 

TRE - 3096: pBlk must be a valid Blk pointer. 

TreVisitSuccPreOrder( pTre, pBlk ) 

TRE - 3140: pTre must be a valid Tre pointer. 

TRE - 3141 : pBlk must be a valid Blk pointer. 

TreVisitSuccessors( pTre, pBlk ) 

TRE - 3186: pTre must be a valid Tre pointer. 

TRE - 3187: pBlk must be a valid Blk pointer. 

TskBasicAssert( condition, fileName, lineNo ) 

None 

TskCondition( pTsk, type, error, fileName, lineNo ) 



TSK-122 
TSK-123 
TSK - 124 
TSK-125 



pTsk must be a valid Tsk pointer. 

The exception stack must not be empty for the Task pTsk. 

There must be no recursion of the exception. 

The condition category must be valid. 
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TskDeInit( pTsk ) 

TSK-159: pTsk must be a valid Tsk pointer. 

TSK-163: pTsk must be a valid Tsk pointer. 

TskDefaultInitDos( pTsk, argc, argv ) 

None 

TskExit( pTsk, exitVal ) 

TSK - 241 : pTsk must be a valid Tsk pointer. 

TskExitWithMsg( pTsk, msg ) 

TSK -288: pTsk must be a valid Tsk pointer. 

TskGetArgc( pTsk ) 

TSK - 315: pTsk must be a valid Tsk pointer. 

TskGetArgv( pTsk ) 

TSK -345: pTsk must be a valid Tsk pointer. 

TskGetExceptionCondition( pTsk ) 

TSK - 376: pTsk must be a valid Tsk pointer. 

TskGetExceptionFileName( pTsk ) 

TSK - 408: pTsk must be a valid Tsk pointer. 

TskGetExceptionLineNo( pTsk ) 

TSK -439: pTsk must be a valid Tsk pointer. 

TskGetExceptionType( pTsk ) 

TSK - 468: pTsk must be a valid Tsk pointer. 
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TsklnitDosC pTsk, argc, argv, maxNesting, excFilter ) 

TSK - 518: pTsk must be a valid Tsk pointer. 

Tsklslnitialized( Void ) 

None 

TskLogCond( pTsk, error ) 

None 

TskMairtLogCond( error ) 

None 

TskMainPreCond( error ) 

None 

TskMainPtrCond( error ) 

None 

TskMainRaiseException( error ) 

None 

TskNormalExit( pTsk ) 

TSK - 776: pTsk must be a valid Tsk pointer. 

TskOnException( pTsk ) 

None 
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TskPopExceptionHandler( pTsk ) 

TSK -854: pTsk must be a valid Tsk pointer. 

TSK - 855: The exception stack must not be empty for the Task pTsk. 

TskPreCond( pTsk, error ) 

None 

TskPrintException( pTsk ) 

TSK -918: pTsk must be a valid Tsk pointer. 

TskPropagateExceptiort( pTsk, useFilter ) 



TSK - 952 
TSK -953 
TSK -954 



pTsk must be a valid Tsk pointer. 

The exception stack must not be empty for the Task pTsk. 

There must be no recursion of the exception. 



TskPtrCond( pTsk, error ) 

None 

TskPushExh( pTsk ) 

TSK - 1025: pTsk must be a valid Tsk pointer. 

TSK - 1 026: The exception stack must not be full for the Task pTsk. 

TskRaiseException( pTsk, error ) 
None 

VtxAsGrfLel(pVtx) 

VTX - 95: pVtx must be a valid Vtx pointer. 

■ VtxAsInDll( pVtx ) 

VTX - 127: pVtx must be a valid Vtx pointer. 
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VtxAsObj(pVtx) 



VTX-160: 



pVtx must be a valid Vtx pointer. 



VtxAsOutDU( pVtx) 

VTX - 192: 



pVtx must be a valid Vtx pointer. 



VtxClear( pVtx ) 



VTX -219: 
VTX- 225: 
VTX -229: 



pVtx must be a valid Vtx pointer. 

Failed to disconnect from edges 

pVtx cannot have edges without being in a Graph 



VtxConnectToGrf ( pVtx, pGrf ) 



VTX -257: 
VTX -258: 
VTX -259 
VTX -260: 



pVtx must be a valid Vtx pointer. 

pGrf must be a valid Grf pointer. 

pVtx must not already be linked to a graph. 

pVtx must have no edges. 



VtxCountIn( pVtx ) 

VTX -291: 



pVtx must be a valid Vtx pointer. 



VtxCountOut( pVtx ) 



VTX -322: 



pVtx must be a valid Vtx pointer. 



VtxDeInit( pVtx ) 



VTX -354 
VTX -355 
VTX -356: 
VTX -362 



pVtx must be a valid Vtx pointer. 

pVtx must have no edges. 

pVtx must not already be linked to a graph. 

pVtx must be a valid Vtx pointer. 



VtxDestroy( pVtx ) 



VTX -390: 
VTX -391: 



pVtx must be a valid Vtx pointer. 
pVtx must not have a sub-object 
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VtxDisconnectFromGrf ( pVtx ) 

VTX - 421 : pVtx must be a valid Vtx pointer. 

VTX -422: pVtx must be linked to a graph. 

VTX - 423: pVtx must have no edges. 



VtxFindOutEdg( pVtxO, pVtxI, offset, pBlk ) 

VTX -490: pVtxO must be a valid Vtx pointer. 

VTX - 491 : pVtxI must be a valid Vtx pointer. 

VTX -492: pBlk must be a valid Blk pointer. 

VtxFindOutEdgClient( pVtxO, pVtxI, offset, pBlk ) 

VTX -563: pVtxO must be a valid Vtx pointer. 

VTX -564: pVtxI must be a valid Vtx pointer. 

VTX -565: pBlk must be a valid Blk pointer. 



VtxGetClient( pVtx, offset ) 

VTX -599: pVtx must be a valid Vtx pointer. 

VtxGetFirstIn( pVtx ) 

VTX - 631: pVtx must be a valid Vtx pointer. 



VtxGetFirstOut( pVtx ) 

VTX -663: 

VtxGetGrf ( pVtx ) 

VTX -692: 

Vtxlnit( pVtx ) 

VTX -721: 

VtxInGrf( pVtx ) 

VTX -751: 



pVtx must be a valid Vtx pointer. 



pVtx must be a valid Vtx pointer. 



pVtx must be a valid Vtx pointer. 



pVtx must be a valid Vtx pointer. 
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VtxSendDestroy( pVtx ) 

VTX -780: pVtx must be a valid Vtx pointer. 

VtxStackSetup( pVtx, inStack, outStack, stackVtx, i ) 

VTX -809: pVtx must be a valid Vtx pointer. 



VtxVisitEdge( pVtx, pBlk ) 

VTX - 847: pVtx must be a valid Vtx pointer. 

VTX - 848: pBlk must be a valid Blk pointer. 



VtxVisitEdgeClient( pVtx, offset, pBlk ) 

VTX -889: pVtx must be a valid Vtx pointer. 

VTX - 890: pBlk must be a valid Blk pointer. 

VtxVisitInEdge( pVtx, pBlk ) 

VTX - 926: pVtx must be a valid Vtx pointer. 

VTX - 927: pBlk must be a valid Blk pointer. 



VtxVisitInEdgeClient( pVtx, offset, pBlk ) 

VTX -969: pVtx must be a valid Vtx pointer. 

VTX -970: pBlk must be a valid Blk pointer. 



VtxVisitOutEdge( pVtx, pBlk ) 

VTX -1006: pVtx must be a valid Vtx pointer. 



VtxVisitOutEdgeClient( pVtx, offset, pBlk ) 

VTX - 1048: pVtx must be a valid Vtx pointer. 
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